show_free_dlg(xml, is_ret_xml, separator)
Данная команда позволяет создать диалог по его xml описанию.
Команда на вход принимает параметры:
- xml – XML описание создаваемого диалога, это строка, что должна иметь один корневой элемент, содержащий элементы управления которые будут показаны в диалоге, тип элемента управления определяется его именем.(см ниже список) Все элементы, должны иметь следующие атрибуты:
- x – x позиция верхнего угла элемента
- y – y позиция верхнего угла элемента
- width – длина элемента
- height – высота элемента
- value – значение, в CHECKBOX – отображает отметку галочки, во всех остальных текст элемента
- button – текст кнопки для элементов спаренных с кнопкой (например выбор файла или папки)
- command – ключ по которому будут помнится предыдущий выбор (например выбор файла или папки)
- ext – для диалога выбора файла - расширения выбираемых файлов, а для диалога выбора папки - дополнительный текст появляющийся при выборе в самом диалоге
Список имён элементов:
- EDIT – поле ввода текста
- CHECKBOX – кнопка пометки галочкой
- LABEL – надпись
- COMBOBOX – выпадающий список элементов
- LISTBOX – обычный список элементов
- MULTIEDIT – мультистрочное поле ввода текста
- TREE – дерево
- FILESELECT – выбор файла
- FOLDERSELECT – выбор папки
- separator – последовательность символов, которыми будут разделены результаты
- is_ret_xml
После отработки команда возвращает результат своей работы в робот:
- true - успешно создан
- false - создать не удалось