Диалоговые окна

Показать окно

Блок позволяет создавать свои собственные окна (формы) и отображать их в модальном и немодальном режиме, в том числе асинхронно по отношению к ходу сценария. Если задан селектор, координаты созданного окна будут привязаны элементу управления в другом приложении. Для создания и редактирования своего окна воспользуйтесь кнопкой «Редактировать...» блока, а для создания переиспользуемых окон - кнопкой «Редактор окон» на главной панели инструментов. Каждый вызов данного блока показывает либо обновляет данные окна (если окно уже на экране). В случае если окно немодальное, повторный вызов блока «Показать окно» позволяет динамически обновлять элементы управления в окне и переменные, которые привязаны к элементам окна. Значения каждого из элементов управления, а также действия пользователей в окне могут быть привязаны к изменению значений выбранных переменных, и наоборот - изменение значений переменных приводит к изменению значений соответствующих элементов управления. Этот функционал позволяет разрабатывать в рамках сценария робота разветвленные диалоговые и экспертные системы, окна настроек робота, интерактивные подсказки и помощников, а также целые многооконные приложения.

Конфигурация	[Текст/Объект] Строка конфигурации. Для редактирования значения необходимо использовать кнопку на блоке "Редактировать".
Объект окна	[Объект] Переменная с объектом окна. Объект окна можно получить из предыдующего блока "Показать окно" в сценарии и это актуально для отображения окна в не модальном режиме
Модальное	При включении окно будет показано как модальное. Иначе после отображения окна управление сразу перейдет в скрипт
Селектор	[Селектор] Идентификатор элемента, к которому будет привязано окно при его отображении. Если селектор не задан, то свойство игнорируется. Если элемент будет найден, то окно будет отображаться в зависимости от заданных настроек в свойствах этого блока. Если селектор не будет найден, то окно будет отображаться посередине экрана.
ID процесса	[Ссылка] Переменная, в которой хранится идентификатор процесса. Указывает, с каким приложением необходимо работать. Если указанное приложение свернуто или его окно закрыто другими окнами, то оно будет выведено на передний план. При работе с браузерами ID процесса дополнительно указывает на конкретную вкладку браузера, с которой должен работать блок. Если свойство оставить пустым, либо если переменная ID процесса не была ранее присвоена в момент запуска приложения или открытия браузера, приложение и вкладка браузера будут определены из содержимого соответствующей строки селектора. ID процесса может быть получен, например, с помощью блоков Запустить приложение или Получить процесс.
ThumbImage	Thumb Image
Угол привязки	Выбор значения угла привязки окна. Если селектор задан, то значение указывает привязку левого верхнего угла окна к углу найденного элемента (при этом значение "Default" будет указывать на центр элемента). Если селектор задан, но не был найден, то при любом значении свойства окно отобразится посередине окна. Если селектор не задан, то свойство указывает привязку окна к рабочей области основного экрана.
Смещение X	[Число] Смещение по координате X при отображении окна. Если селектор не задан и угол привязки равен "Default", а данное свойство имеет значение, то это значение будет считаться абсолютными координатами для отображения окна
Смещение Y	[Число] Смещение по координате Y при отображении окна. Если селектор не задан и угол привязки равен "Default", а данное свойство имеет значение, то это значение будет считаться абсолютными координатами для отображения окна
Событие элемента	[Текст] Сгенерированное событие элементом на форме. Формат значения: "ControlName.EventName". Если кнопка на форме содержит значение DialogResult, то это значение будет указано в этом свойстве. Например: "OK", "Cancel"
Объект окна	[Объект] Возвращается созданный объект окна. Данное свойство полезно если показывать окно без использования модальности. Для этого в следующем блоке укажите переменную из этого свйоства. В этом случае произойдет обновление данных в окне без создания нового экземпляра окна
Уровень обработки	Выбор уровня обработки ошибок. Возможные значения: "Default" - по умолчанию; "Ignore" - ошибки игнорируются; "Handle" - ошибки обрабатываются. Если выбрано значение "Default", то будет использоваться значение блока "Старт" данной диаграммы
Уровень сообщений	Выбор уровня сообщений, которые будут выводить блоки при работе. Возможные значения: "Default" - по умолчанию; "Release" - вывод отключен; "Debug" - вывод основной информации; "Detailed" - вывод подробной информации. Если выбрано значение "Default", то будет использоваться значение блока "Старт" данной диаграммы
Текст ошибки	[Текст] Возвращает подробную информацию об ошибке в случае некорректного выполнения работы блока

Окно с сообщением

Показать пользователю модальное диалоговое окно с заданным заголовком, текстом и набором кнопок. Если используется окно с несколькими кнопками, блок позволяет записать в переменную текстовую константу, соответствующую нажатой пользователем кнопке.

Заголовок	[Текст] Текст, значение переменной или результат вычислений, который будет отображен в заголовке диалогового окна
Сообщение	[Текст] Текст, значение переменной или результат вычислений, который будет отображен внутри диалогового окна
Кнопки	Кнопки, которые будут доступны пользователю для нажатия
Изображение	Изображение, которое будет отображаться в диалоговом окне
Время ожидания	[Число] Время ожидания. Если задано значение больше нуля, то окно автоматически закроется через это время. В свойство "Результат" при этом будет записано первое значение из указанных в свойстве "Кнопки".
Перенос строк	Включается перенос строк
Результат	[Текст] Переменная, в которую будет сохранено название кнопки, нажатой пользователем. Один из возможных результатов: OK, Cancel, Yes, No. Данные текстовые константы не зависят от языка робота или операционной системы
Уровень обработки	Выбор уровня обработки ошибок. Возможные значения: "Default" - по умолчанию; "Ignore" - ошибки игнорируются; "Handle" - ошибки обрабатываются. Если выбрано значение "Default", то будет использоваться значение блока "Старт" данной диаграммы
Уровень сообщений	Выбор уровня сообщений, которые будут выводить блоки при работе. Возможные значения: "Default" - по умолчанию; "Release" - вывод отключен; "Debug" - вывод основной информации; "Detailed" - вывод подробной информации. Если выбрано значение "Default", то будет использоваться значение блока "Старт" данной диаграммы
Текст ошибки	[Текст] Возвращает подробную информацию об ошибке в случае некорректного выполнения работы блока

Окно для ввода текста

Показать модальное диалоговое окно, предназначенное для получения информации от пользователя.

Заголовок	[Текст] Текст, значение переменной или результат вычислений, который будет отображен в заголовке диалогового окна
Сообщение	[Текст] Текст, значение переменной или результат вычислений, который будет отображен внутри диалогового окна
Значение по умолчанию	[Текст] Значение, которое сразу будет отображаться в окне ввода. Если пользователь отменит ввод, то это значение будет присвоено результату
Время ожидания	[Число] Время ожидания. Если задано значение больше нуля, то окно автоматически закроется через это время. В свойство "Результат" при этом будет записано значение по умолчанию
Перенос строк	Включается перенос строк
Результат	[Текст] В указанную переменную будет сохранен текст, который пользователь ввел в диалоговое окно
Уровень обработки	Выбор уровня обработки ошибок. Возможные значения: "Default" - по умолчанию; "Ignore" - ошибки игнорируются; "Handle" - ошибки обрабатываются. Если выбрано значение "Default", то будет использоваться значение блока "Старт" данной диаграммы
Уровень сообщений	Выбор уровня сообщений, которые будут выводить блоки при работе. Возможные значения: "Default" - по умолчанию; "Release" - вывод отключен; "Debug" - вывод основной информации; "Detailed" - вывод подробной информации. Если выбрано значение "Default", то будет использоваться значение блока "Старт" данной диаграммы
Текст ошибки	[Текст] Возвращает подробную информацию об ошибке в случае некорректного выполнения работы блока

Выбор папки

Отображает диалоговое окно, позволяющее пользователю выбрать папку.

Заголовок	[Текст] Текст, значение переменной или результат вычислений, который будет отображен в заголовке диалогового окна
Результат	[Текст] В указанную переменную будет сохранена выбранная папка
Уровень обработки	Выбор уровня обработки ошибок. Возможные значения: "Default" - по умолчанию; "Ignore" - ошибки игнорируются; "Handle" - ошибки обрабатываются. Если выбрано значение "Default", то будет использоваться значение блока "Старт" данной диаграммы
Направление выхода	Выбор направления выхода из блока при возникновении ошибки. Возможные значения: "Default" - по умолчанию; "Right" - направо; "Bottom" - вниз. Данное свойство позволяет определить направление выхода при возникновении ошибок для блоков не содержащих коннектора "Если ошибка" (например блок "Условие"). Если выбрано значение "Default", то будет использоваться значение блока "Старт" данной диаграммы
Уровень сообщений	Выбор уровня сообщений, которые будут выводить блоки при работе. Возможные значения: "Default" - по умолчанию; "Release" - вывод отключен; "Debug" - вывод основной информации; "Detailed" - вывод подробной информации. Если выбрано значение "Default", то будет использоваться значение блока "Старт" данной диаграммы
Текст ошибки	[Текст] Возвращает подробную информацию об ошибке в случае некорректного выполнения работы блока

Открыть файл

Отображает диалоговое окно, позволяющее пользователю открыть файл.

Заголовок	[Текст] Текст, значение переменной или результат вычислений, который будет отображен в заголовке диалогового окна
Фильтр	[Текст] При необходимости можно задать фильтр файлов. Для каждого параметра фильтрации строка фильтра содержит описание фильтра, за которым следуют вертикальная черта (|) и шаблон фильтра. Строки для различных параметров фильтрации разделяются вертикальной чертой. Например: "Text files (*.txt)|*.txt|All files (*.*)|*.*" - в диалоге будет дан выбор между двумя параметрами: "Text files (*.txt)" и "All files (*.*)"
Расширение по умолчанию	[Текст] Расширение имени файла по умолчанию. Свойство используется только в том случае, если в поле фильтра выбрано "Все файлы (*.*)" и пользователь не указал расширение. Например: "txt" (без точки)
Путь к файлу	[Текст] Возвращается путь к файлу, который выбрал пользователь
Уровень обработки	Выбор уровня обработки ошибок. Возможные значения: "Default" - по умолчанию; "Ignore" - ошибки игнорируются; "Handle" - ошибки обрабатываются. Если выбрано значение "Default", то будет использоваться значение блока "Старт" данной диаграммы
Направление выхода	Выбор направления выхода из блока при возникновении ошибки. Возможные значения: "Default" - по умолчанию; "Right" - направо; "Bottom" - вниз. Данное свойство позволяет определить направление выхода при возникновении ошибок для блоков не содержащих коннектора "Если ошибка" (например блок "Условие"). Если выбрано значение "Default", то будет использоваться значение блока "Старт" данной диаграммы
Уровень сообщений	Выбор уровня сообщений, которые будут выводить блоки при работе. Возможные значения: "Default" - по умолчанию; "Release" - вывод отключен; "Debug" - вывод основной информации; "Detailed" - вывод подробной информации. Если выбрано значение "Default", то будет использоваться значение блока "Старт" данной диаграммы
Текст ошибки	[Текст] Возвращает подробную информацию об ошибке в случае некорректного выполнения работы блока

Сохранить файл

Отображает диалоговое окно, позволяющее пользователю сохранить файл.

Заголовок	[Текст] Текст, значение переменной или результат вычислений, который будет отображен в заголовке диалогового окна
Фильтр	[Текст] При необходимости можно задать фильтр файлов. Для каждого параметра фильтрации строка фильтра содержит описание фильтра, за которым следуют вертикальная черта (|) и шаблон фильтра. Строки для различных параметров фильтрации разделяются вертикальной чертой. Например: "Text files (*.txt)|*.txt|All files (*.*)|*.*" - в диалоге будет дан выбор между двумя параметрами: "Text files (*.txt)" и "All files (*.*)"
Расширение по умолчанию	[Текст] Расширение имени файла по умолчанию. Свойство используется только в том случае, если в поле фильтра выбрано "Все файлы (*.*)" и пользователь не указал расширение. Например: "txt" (без точки)
Имя файла по умолчанию	[Текст] Имя файла, которое будет отображаться в окне ввода
Уровень обработки	Выбор уровня обработки ошибок. Возможные значения: "Default" - по умолчанию; "Ignore" - ошибки игнорируются; "Handle" - ошибки обрабатываются. Если выбрано значение "Default", то будет использоваться значение блока "Старт" данной диаграммы
Путь к файлу	[Текст] Возвращается путь к файлу, который выбрал пользователь
Направление выхода	Выбор направления выхода из блока при возникновении ошибки. Возможные значения: "Default" - по умолчанию; "Right" - направо; "Bottom" - вниз. Данное свойство позволяет определить направление выхода при возникновении ошибок для блоков не содержащих коннектора "Если ошибка" (например блок "Условие"). Если выбрано значение "Default", то будет использоваться значение блока "Старт" данной диаграммы
Уровень сообщений	Выбор уровня сообщений, которые будут выводить блоки при работе. Возможные значения: "Default" - по умолчанию; "Release" - вывод отключен; "Debug" - вывод основной информации; "Detailed" - вывод подробной информации. Если выбрано значение "Default", то будет использоваться значение блока "Старт" данной диаграммы
Текст ошибки	[Текст] Возвращает подробную информацию об ошибке в случае некорректного выполнения работы блока

Man in the loop

Блок позволяет перепроверять списки, словари и таблицы. Вносить правки в реальном времени. В свойствах блока можно указывать необходимые данные для просмотра и редактирования. Не используемые свойства необходимо оставить пустыми.

После заполнения свойств и запуска робота с данным блоком на экран будет выводится диалоговое окно, которое позволяет наглядно перепроверять указанные в свойствах списки, словари и таблицы, в котором можно будет сразу внести правки.

Примечание: желательно не оставлять пустым свойство "Путь к файлу", потому как оно отображает ключевую информацию, о чем идет речь.

Путь к файлу	[Текст] Путь к файлу. Указывается файл, который можно открыть в предпросмотре. Поддерживаемые форматы: .pdf; .png; .jpg; .jpeg; .bmp
Список	[Список] Список для просмотра и редактирования
Словарь	[Словарь] Словарь для просмотра и редактирования
Таблица данных	[Таблица Данных] Таблица данных для просмотра и редактирования
Названия кнопок	Названия кнопок для отображения в окне блока. Возможные значения: OK/Cancel - ОК/Отмена; Accept/Reject - Принять/Отклонить; Custom - свое значение, которое указывается в свойстве "Свои названия"
Свои названия	[Текст] Свои названия кнопок для отображения в окне. Чтобы использовать это свойство необходимо в свойстве "Названия кнопок" выбрать "Custom". Названия разделяются символом /: например "Название1/Название2"
Список	[Список] Отредактированный список
Словарь	[Словарь] Отредактированный словарь
Таблица данных	[Таблица Данных] Отредактированная таблица данных
Кнопка	[Текст] Название кнопки, на которую нажали в окне блока
Уровень обработки	Выбор уровня обработки ошибок. Возможные значения: "Default" - по умолчанию; "Ignore" - ошибки игнорируются; "Handle" - ошибки обрабатываются. Если выбрано значение "Default", то будет использоваться значение блока "Старт" данной диаграммы
Уровень сообщений	Выбор уровня сообщений, которые будут выводить блоки при работе. Возможные значения: "Default" - по умолчанию; "Release" - вывод отключен; "Debug" - вывод основной информации; "Detailed" - вывод подробной информации. Если выбрано значение "Default", то будет использоваться значение блока "Старт" данной диаграммы
Текст ошибки	[Текст] Возвращает подробную информацию об ошибке в случае некорректного выполнения работы блока

Медиаплеер

Воспроизведение аудио-файлов.

Воспроизвести	Выбор типа воспроизведения. Возможные значения: "File" - воспроизводит заданный в свойстве "Путь к файлу" файл; остальные значения воспроизводят звуки из текущей звуковой схемы Windows
Путь к файлу	[Текст] Имя и путь к файлу, который необходимо воспроизвести. Поддерживаются все форматы файлов, содержащие аудио-дорожку. Например: wav;mp3;mp4;avi;mkv и другие
Играть в фоне	Если выбрано, то файл будет воспроизводится в фоне, а работа диаграммы продолжится не останавливаясь. Иначе работа остановится пока файл не будет проигран полностью
Уровень обработки	Выбор уровня обработки ошибок. Возможные значения: "Default" - по умолчанию; "Ignore" - ошибки игнорируются; "Handle" - ошибки обрабатываются. Если выбрано значение "Default", то будет использоваться значение блока "Старт" данной диаграммы
Уровень сообщений	Выбор уровня сообщений, которые будут выводить блоки при работе. Возможные значения: "Default" - по умолчанию; "Release" - вывод отключен; "Debug" - вывод основной информации; "Detailed" - вывод подробной информации. Если выбрано значение "Default", то будет использоваться значение блока "Старт" данной диаграммы
Текст ошибки	[Текст] Возвращает подробную информацию об ошибке в случае некорректного выполнения работы блока