Действия с окнами сообщений
Окна сообщений можно использовать в классических потоках для взаимодействия с пользователями, запроса ввода и вывода результатов.
Чтобы отобразить сообщение пользователю во время выполнения потока, используйте действие Показать сообщение. Необходимо указать заголовок окна сообщения, его содержимое, значок и кнопки в отображаемом окне. Кроме того, вы можете установить кнопку по умолчанию для предварительного выбора, а также указать, должно ли окно сообщения всегда находиться поверх всех других окон на вашем компьютере и должно ли окно сообщения закрываться автоматически через определенное время.
В приведенном здесь примере отображается окно сообщения, которое информирует пользователя о завершении синтаксического анализа и спрашивает, следует ли анализировать другой файл. Окно сообщения содержит значок вопроса и всегда находится поверх других окон. Выбор пользователя будет храниться в переменной ButtonPressed.
Созданное окно сообщения будет похоже на следующий пример:
В дополнение к этому вы можете создать пользовательскую форму для отображения сообщения в рамках вашего потока с помощью действия Показать пользовательскую форму. Пользовательская форма принимает несколько элементов, и вы можете создать пользовательскую форму, содержащую различные типы ввода и кнопки. Дополнительные сведения: Создание пользовательских форм.
Чтобы запросить ввод данных с использованием диалогового окна, используйте действие Показать диалоговое окно ввода. Для этого действия требуется заголовок диалогового окна и сообщение в качестве подсказки для пользователя. При желании вы можете установить значение по умолчанию и тип ввода (однострочный, многострочный или пароль).
Используйте действия Показать диалоговое окно выбора файла, чтобы предложить пользователю найти файл. В следующем примере пользователю предлагается выбрать файл изображения. Исходная папка задана переменной, а фильтр файлов разрешает выбирать только файлы с определенными расширениями.
Созданное диалоговое окно для выбора файла будет похоже на следующий пример. Заданный фильтр виден в правом нижнем углу диалогового окна.
Показать сообщение
Отображает окно сообщения.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| Message box title | Да | Текстовое значение | Текст для использования в качестве заголовка окна сообщения. | |
| Message to display | Да | Текстовое значение | Текст для отображения в качестве фактического сообщения | |
| Message box icon | Н/Д | Нет, Информация, Вопрос, Предупреждение, Ошибка | Без доступа | Значок для отображения в окне сообщения. |
| Message box buttons | Н/Д | ОК, ОК – Отмена, Да – Нет, Да – Нет – Отмена, Прервать – Повторить – Игнорировать, Повторить – Отмена | OK | Кнопки для отображения в окне сообщения |
| Default button | Н/Д | Первая кнопка, Вторая кнопка, Третья кнопка | Первая кнопка | Кнопка, которую нужно выделить по умолчанию. Если пользователь нажимает Ввод, эта кнопка будет нажата |
| Окно сообщения всегда наверху | Н/Д | Логическое значение | Ложь | Укажите, должно ли окно сообщения всегда оставаться поверх остальных окон. |
| Close message box automatically | Н/Д | Логическое значение | Ложь | Укажите, закрывается ли окно сообщения автоматически по истечении заданного времени, как если бы была нажата кнопка по умолчанию. В противном случае поток будет ждать, пока пользователь не нажмет кнопку |
| Timeout | Да | Числовое значение | 3 | Время в секундах для приостановки автоматизации в ожидании ввода, после чего поток будет продолжен автоматически |
Создаваемые переменные
| Аргумент | Type | Description |
|---|---|---|
| ButtonPressed | Текстовое значение | Текст нажатой кнопки |
Исключения
| Исключение | Описание |
|---|---|
| Не удалось отобразить окно сообщения. | Указывает на проблему при отображении диалога сообщения. |
| Невозможно отобразить окно сообщения в неинтерактивном режиме | Указывает на проблему при отображении диалога сообщения в неинтерактивном режиме. |
Показать диалог ввода
Отображает диалоговое окно с приглашением ввести текст.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| Input dialog title | Да | Текстовое значение | Заголовок диалога | |
| Input dialog message | Да | Текстовое значение | Сообщение диалога | |
| Default value | Да | Текстовое значение | Укажите текст для отображения по умолчанию. Если пользователь желает изменить этот текст, он может набрать текст поверх него. В противном случае будет использоваться текст по умолчанию | |
| Input type | Н/Д | Одна строка, Пароль, Многострочное | Однострочное | Формат вводимого текста. Выберите "Однострочное — пароль", чтобы скрыть текст, или "Многострочное", чтобы можно было показывать более одной строки текста |
| Keep input dialog always on top | Н/Д | Логическое значение | Ложь | Укажите, должен ли диалог ввода всегда оставаться поверх остальных окон. |
Создаваемые переменные
| Аргумент | Type | Description |
|---|---|---|
| UserInput | Текстовое значение | Текст, введенный пользователем, или текст по умолчанию. |
| ButtonPressed | Текстовое значение | Текст нажатой кнопки. Пользователю будет автоматически предоставлен выбор "ОК" или "Отмена" |
Исключения
| Исключение | Описание |
|---|---|
| Не удалось отобразить диалог ввода. | Указывает на проблему при отображении диалога ввода. |
| Невозможно отобразить диалог ввода в неинтерактивном режиме. | Указывает на проблему при отображении диалога ввода в неинтерактивном режиме. |
Отобразить диалог выбора даты
Отображает диалоговое окно с приглашением ввести дату или диапазон дат.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| Dialog title | Да | Текстовое значение | Заголовок диалога | |
| Dialog message | Да | Текстовое значение | Сообщение диалога | |
| Dialog type | Неприменимо | Одна дата, Диапазон дат (две даты) | Одна дата | Будет ли пользователь вводить одну дату или две даты (определяющие диапазон) |
| Prompt for | Н/Д | Только дата, Дата и время | Только дата | Укажите, будет ли пользователь вводить только дату или же дату и время. |
| Default value | Да | Дата и время | Значение даты по умолчанию | |
| Default value for second date | Да | Дата и время | Значение по умолчанию для конечной даты диапазона | |
| Keep date selection dialog always on top | Н/Д | Логическое значение | Ложь | Укажите, должен ли диалог выбора даты всегда оставаться поверх остальных окон. |
Создаваемые переменные
| Аргумент | Type | Description |
|---|---|---|
| SelectedDate | Дата и время | Дата, введенная пользователем, или дата по умолчанию |
| SecondSelectedDate | Дата и время | Вторая дата, введенная пользователем, или дата по умолчанию |
| ButtonPressed | Текстовое значение | Текст кнопки, нажатой пользователем. Пользователю будет автоматически предоставлен выбор "ОК" или "Отмена" |
Исключения
| Исключение | Описание |
|---|---|
| Не удалось отобразить диалог выбора даты. | Указывает на проблему при отображении диалога выбора даты. |
| Невозможно отобразить диалог выбора даты в неинтерактивном режиме. | Указывает на проблему при отображении диалога ввода в неинтерактивном режиме. |
Отобразить диалог выбора из списка
Отображает диалоговое окно с вариантами, позволяющими пользователю сделать выбор из списка.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| Dialog title | Да | Текстовое значение | Заголовок диалога | |
| Dialog message | Да | Текстовое значение | Сообщение диалога | |
| List to choose from | Нет | Общее значение | Список, отображаемый в виде раскрывающегося меню, чтобы пользователь мог выбрать нужный вариант. | |
| Keep select dialog always on top | Н/Д | Логическое значение | Ложь | Укажите, должен ли диалог выбора всегда оставаться поверх остальных окон. |
| Limit to list | Н/Д | Логическое значение | Истина | Нужно ли разрешить ли пользователю вводить собственный ответ (значение не из отображаемого списка) |
| Allow empty selection | Н/Д | Логическое значение | Ложь | Разрешить пользователю ничего не выбирать, создав пустой выбранный выходной элемент. |
| Разрешить выбор нескольких элементов | Неприменимо | Логическое значение | False | Разрешить пользователю выбрать несколько вариантов. Переменные выбранного элемента и индекса будут содержать список значений |
| Preselect items starting with a + sign | Н/Д | Логическое значение | Ложь | Укажите, будут ли элементы с символом "+" в начале выбираться автоматически. |
Создаваемые переменные
| Аргумент | Type | Description |
|---|---|---|
| SelectedItem | Текстовое значение | Элемент, выбранный из списка, в виде текста. |
| SelectedItems | Списоктекстовых значений | Элементы, выбранные из списка, в виде списка текстовых строк. |
| SelectedIndex | Числовое значение | Номер индекса элемента, выбранного из списка. Вы можете использовать номер элемента вместо полного текста выбранного варианта |
| SelectedIndexes | Списокчисловых значений | Номер индекса элементов, выбранный из списка. Это позволяет использовать номер элемента, а не полный текст выбранного варианта |
| ButtonPressed | Текстовое значение | Имя кнопки, нажатой пользователем ("ОК" или "Отмена"). |
Исключения
| Исключение | Описание |
|---|---|
| Не удалось отобразить диалог выбора. | Указывает на проблему при отображении диалога выбора. |
| Невозможно отобразить диалог выбора в неинтерактивном режиме | Указывает на проблему при отображении диалога ввода в неинтерактивном режиме. |
Отобразить диалог выбора файла
Отображает диалоговое окно выбора файла и приглашает пользователя выбрать один или несколько файлов.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| Dialog title | Да | Текстовое значение | Заголовок диалога | |
| Initial folder | Да | Папка | Начальная папка, которая открывается при поиске файла. В этой папке пользователь начнет искать файлы при открытии действием диалогого окна для выбора файла | |
| Фильтр файлов | Да | Текстовое значение | Фильтр для ограничения извлекаемых файлов. Этот параметр позволяет использовать подстановочные символы, например ".txt" или "document?.doc". Чтобы настроить несколько фильтров, разделите их точкой с запятой, например ".txt;*.exe" | |
| Keep file selection dialog always on top | Н/Д | Логическое значение | Ложь | Должен ли диалог выбора файла всегда оставаться поверх остальных окон. |
| Разрешить выбор нескольких элементов | Неприменимо | Логическое значение | False | Может ли пользователь выбрать более одного файла. |
| Check if file exists | Н/Д | Логическое значение | Ложь | Будут ли приниматься только файлы, которые уже существуют. |
Создаваемые переменные
| Аргумент | Type | Description |
|---|---|---|
| SelectedFile | Файл | Файл, который будет выбран через этот диалог. |
| SelectedFiles | Списокфайлов | Выбранные файлы |
| ButtonPressed | Текстовое значение | Текст нажатой кнопки. Пользователю будет автоматически предоставлен выбор "Открыть" или "Отмена" |
Исключения
| Исключение | Описание |
|---|---|
| Не удалось отобразить диалог выбора файла. | Указывает на проблему при отображении диалога выбора файла. |
| Невозможно отобразить диалог выбора файла в неинтерактивном режиме | Указывает на проблему при отображении диалога ввода в неинтерактивном режиме. |
Отобразить диалог выбора папки
Отображает диалоговое окно выбора папки и приглашает пользователя выбрать папку.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
|---|---|---|---|---|
| Dialog description | Да | Текстовое значение | Описание диалога выбора папки. Например: "Выберите папку, в которую нужно скопировать файлы". | |
| Initial folder | Да | Папка | Начальная папка для открытия. Это папка будет использоваться по умолчанию, если пользователь не выбрал другую | |
| Keep folder selection dialog always on top | Н/Д | Логическое значение | Ложь | Должен ли диалог выбора папки всегда оставаться поверх остальных окон. |
Создаваемые переменные
| Аргумент | Type | Description |
|---|---|---|
| SelectedFolder | Папка | Выбранная папка |
| ButtonPressed | Текстовое значение | Текст нажатой кнопки. Пользователю будет автоматически предоставлен выбор "ОК" или "Отмена" |
Исключения
| Исключение | Описание |
|---|---|
| Не удалось отобразить диалог выбора папки. | Указывает на проблему при отображении диалога выбора папки. |
| Невозможно отобразить диалог выбора папки в неинтерактивном режиме | Указывает на проблему при отображении диалога ввода в неинтерактивном режиме |
Показать пользовательскую форму
Отображение специально разработанной формы, которая может включать в себя элементы различных типов, например поля для ввода текста, чисел, файлов и т. д.
Входные параметры
Входные параметры настраиваются через конструктор пользовательских форм.
Создаваемые переменные
| Аргумент | Type | Description |
|---|---|---|
| CustomFormData | Пользовательский объект | Пользовательский объект, содержащий введенные пользователем данные |
| ButtonPressed | Текстовое значение | ИД нажатой кнопки |
Исключения
| Исключение | Описание |
|---|---|
| Не удалось отобразить пользовательскую форму | Указывает на проблему с отображением пользовательской формы |