====== show_free_dlg ======

**Каноническая страница:** [[https://humanemulator.net/objects/WINDOW/app/std_dialogs/show_free_dlg.php|https://humanemulator.net/objects/WINDOW/app/std_dialogs/show_free_dlg.php]]

[[objects:start|← Objects]]

----

Справка Human Emulator app: show_free_dlg

App"; ?>

show_free_dlg

show_free_dlg($xml,$is_ret_xml=true,$separator="\r\n");
- данная функция используется для создания диалога по его xml описанию
* $xml – XML описание создаваемого диалога, это строка , что должна иметь один корневой элемент, содержащий элементы управления которые будут показаны в диалоге, тип элемента управления определяется его именем.(см ниже список) Все элементы, включая корневой, должны иметь следующие атрибуты:

* x – x позиция верхнего угла элемента

* y – y позиция верхнего угла элемента

* width – длина элемента

* height – высота элемента

* value – значение, в CHECKBOX – отображает отметку галочки, во всех остальных текст элемента

* button – текст кнопки для элементов спаренных с кнопкой (например выбор файла или папки)

* command - ключ по котрому будут помнится предыдущий выбор (например выбор файла или папки)

* ext - для диалога выбора файла - расширения выбираемых файлов, а для диалога выбора папки - дополнительный текст появляющийся при выборе в самом диалоге

Список имён элементов:

* EDIT – поле ввода текста

* CHECKBOX – кнопка пометки галочкой

* LABEL – надпись
* COMBOBOX - выпадающий список элементов
* LISTBOX - обычный список элементов
* MULTIEDIT - мультистрочное поле ввода текста
* TREE - дерево
* FILESELECT - выбор файла (с 4.6.37)
* FOLDERSELECT - выбор папки (с 4.6.37)Пример xml :

		1
		2
		3

		4
		5
		6

'); ?>

* $is_ret_xml – возвращать ли результат работы диалога в xml
* $separator – чем разделять возвращаемые результаты по каждому элементу управления диалогаПосле отработки функция возвращает результат своей работы в скрипт :

* Результат отработки диалога – это xml или строка, описывающая все элементы диалога в том состоянии когда была нажата кнопка OK или Отмена (когда диалог был закрыт)