Сведения о диалоговых окнах задач
Диалоговое окно задачи — это диалоговое окно, которое можно использовать для отображения сведений и получения простых входных данных от пользователя. Как и окно сообщения, оно отформатировано операционной системой в соответствии с заданными параметрами. Однако диалоговое окно задачи имеет гораздо больше возможностей, чем окно сообщения.
Заметка
Для диалогов задачи требуется однопоточная модель (STA).
Части диалогового окна задачи
Диалоговое окно задачи состоит из нескольких элементов, большинство из которых являются необязательными. На следующем рисунке показаны различные части диалогового окна задачи.
На следующем рисунке пользователь щелкнул кнопку рядом с свернутным текстом элемента управления, что привело к отображению альтернативного текста там и в нижнем колонтитуле.
На рисунках показаны следующие части:
| Часть | Описание | Член TASKDIALOGCONFIG |
|---|---|---|
| Заголовок окна | Заголовок окна. | pszWindowTitle |
| Значок "Главная" | Большой значок, указывающий назначение диалогового окна задачи. | hMainIcon или pszMainIcon |
| Основная инструкция | Основной текст. | pszMainInstruction |
| Содержание | Дополнительный текст. | pszContent |
| Индикатор выполнения | Анимированная панель, показывающая ход выполнения какой-то задачи. | dwFlags |
| Радиокнопки | Определяемые приложением параметры для пользователя. | pRadioButtons |
| Настраиваемая кнопка | Кнопка, которая не является одной из распространенных кнопок. Это может быть обычная кнопка или, как показано на рисунке, ссылка на команду с двумя строками текста. | pButtons |
| Кнопка "Развернуть и свернуть" | Кнопка, которую можно использовать для переключения между свораченным приложением текстом элемента управления (например, "Дополнительные сведения") и текстом расширенного элемента управления, который может находиться в двух или более строках. При развёртывании управляющего текста дополнительная информация из pszExpandedInformation также отображается, либо после основного текста, либо (как показано на втором рисунке) в нижнем колонтитуле. | pszCollapsedControlText и pszExpandedControlText |
| Флажок проверки | Флажок, сопровождаемый текстом, определенным приложением, для простых вариантов, таких как "Не показывать это диалоговое окно снова". | pszVerificationText |
| Значок футера | Небольшой значок, указывающий назначение текста нижнего колонтитула. | hFooterIcon или pszFooterIcon |
| Текст нижнего колонтитула | Дополнительный текст. На рисунках текст содержит гиперссылку. | pszFooter |
| Общая кнопка | Стандартная кнопка; на иллюстрациях кнопка "ОК". | dwCommonButtons |