Поделиться через


Диалоговое окно задач

В этом разделе содержатся сведения о элементах программирования, используемых в диалоговом окне задач. Диалоговое окно задачи похоже на гораздо более гибкое, чем простое окно сообщения.

Обзоры

Тема Содержание
диалоговых окон задач Описывает элементы диалогового окна задачи.

Функции

Тема Содержание
TaskDialog Создает, отображает и управляет диалогом задачи. Диалоговое окно задачи содержит текст сообщения и название приложения, значки и любую комбинацию предопределенных кнопок. Эта функция не поддерживает регистрацию функции обратного вызова для получения уведомлений.
TaskDialogCallbackProc Определяемая приложением функция, используемая с функцией TaskDialogIndirect. Он получает сообщения из диалогового окна задачи при возникновении различных событий.
Тип PFTASKDIALOGCALLBACK определяет указатель на эту функцию обратного вызова. TaskDialogCallbackProc является заполнителем для имени определяемой приложением функции.
TaskDialogIndirect Создает, отображает и управляет диалогом задачи. Диалоговое окно задачи содержит значки, сообщения, заголовки, флажок проверки, ссылки команд, кнопки и переключатели. Эта функция может зарегистрировать функцию обратного вызова для получения сообщений уведомлений.

Сообщения

Тема Содержание
TDM_CLICK_BUTTON Имитирует действие нажатия кнопки в диалоговом окне задачи.
TDM_CLICK_RADIO_BUTTON Имитирует действие переключателя в диалоговом окне задачи.
TDM_CLICK_VERIFICATION Имитирует действие флажка проверки в диалоговом окне задачи.
TDM_ENABLE_BUTTON Включает или отключает кнопку нажатия в диалоговом окне задачи.
TDM_ENABLE_RADIO_BUTTON Включает или отключает переключатель в диалоговом окне задачи.
TDM_NAVIGATE_PAGE Повторно создает диалоговое окно задачи с новым содержимым, имитируя функциональные возможности мастера с несколькими страницами.
TDM_SET_BUTTON_ELEVATION_REQUIRED_STATE Указывает, должен ли заданная кнопка диалогового окна задачи или ссылка на команду иметь значок щита контроля учетных записей пользователей (UAC); То есть, требуется ли действие, вызываемое кнопкой, повышение прав.
TDM_SET_ELEMENT_TEXT Обновляет текстовый элемент в диалоговом окне задачи.
TDM_SET_MARQUEE_PROGRESS_BAR Указывает, должен ли размещенный индикатор хода выполнения отображаться в режиме маркирования.
TDM_SET_PROGRESS_BAR_MARQUEE Запускает и останавливает отображение индикатора хода выполнения и задает скорость марша.
TDM_SET_PROGRESS_BAR_POS Задает текущую позицию для индикатора выполнения.
TDM_SET_PROGRESS_BAR_RANGE Задает минимальные и максимальные значения для размещенной панели выполнения.
TDM_SET_PROGRESS_BAR_STATE Задает текущее состояние индикатора выполнения.
TDM_UPDATE_ELEMENT_TEXT Обновляет текстовый элемент в диалоговом окне задачи.
TDM_UPDATE_ICON Обновляет значок диалогового окна задачи.

Уведомления

Тема Содержание
TDN_BUTTON_CLICKED Отправляется диалогом задачи, когда пользователь выбирает кнопку или ссылку команды в диалоговом окне задачи. Этот код уведомления получается только через функцию обратного вызова диалогового окна задачи, которая может быть зарегистрирована с помощью метода TaskDialogIndirect.
TDN_CREATED Отправляется диалогом задачи после создания диалогового окна задачи и перед его отображением. Этот код уведомления получается только через функцию обратного вызова диалогового окна задачи, которая может быть зарегистрирована с помощью метода TaskDialogIndirect.
TDN_DESTROYED Отправляется диалогом задачи при уничтожении и его дескриптор окна больше недействителен. Этот код уведомления получается только через функцию обратного вызова диалогового окна задачи, которая может быть зарегистрирована с помощью метода TaskDialogIndirect.
TDN_DIALOG_CONSTRUCTED Отправляется диалогом задачи после создания диалогового окна задачи и перед его отображением. Этот код уведомления получается только через функцию обратного вызова диалогового окна задачи, которая может быть зарегистрирована с помощью метода TaskDialogIndirect.
TDN_EXPANDO_BUTTON_CLICKED Отправляется диалогом задачи, когда пользователь нажимает кнопку расширения диалогового окна задачи. Этот код уведомления получается только через функцию обратного вызова диалогового окна задачи, которая может быть зарегистрирована с помощью метода TaskDialogIndirect.
TDN_HELP Отправляется диалогом задачи, когда пользователь нажимает клавишу F1 на клавиатуре, пока диалоговое окно задачи имеет фокус. Этот код уведомления получается только через функцию обратного вызова диалогового окна задачи, которая может быть зарегистрирована с помощью метода TaskDialogIndirect.
TDN_HYPERLINK_CLICKED Отправляется диалогом задачи, когда пользователь щелкает гиперссылку в содержимом диалогового окна задачи. Этот код уведомления получается только через функцию обратного вызова диалогового окна задачи, которая может быть зарегистрирована с помощью метода TaskDialogIndirect.
TDN_NAVIGATED Отправляется диалогом задачи при возникновении навигации. Этот код уведомления получается только через функцию обратного вызова диалогового окна задачи, которая может быть зарегистрирована с помощью метода TaskDialogIndirect.
TDN_RADIO_BUTTON_CLICKED Отправляется диалогом задачи, когда пользователь выбирает кнопку или ссылку команды в диалоговом окне задачи. Этот код уведомления получается только через функцию обратного вызова диалогового окна задачи, которая может быть зарегистрирована с помощью метода TaskDialogIndirect.
TDN_TIMER Отправляется диалогом задач примерно каждые 200 миллисекунда. Этот код уведомления отправляется, когда флаг TDF_CALLBACK_TIMER был установлен в dwFlags член структуры TASKDIALOGCONFIG, передан ной в функцию TaskDialogIndirect. Этот код уведомления получается только через функцию обратного вызова диалогового окна задачи, которую можно зарегистрировать с помощью метода TaskDialogIndirect.
TDN_VERIFICATION_CLICKED Отправляется диалогом задачи, когда пользователь щелкает флажок проверки диалогового окна задачи. Этот код уведомления получается только через функцию обратного вызова диалогового окна задачи, которая может быть зарегистрирована с помощью метода TaskDialogIndirect.

Структуры

Тема Содержание
TASKDIALOG_BUTTON Содержит сведения, используемые для отображения кнопки в диалоговом окне задачи. Структура taskDIALOGCONFIGиспользует эту структуру.
TASKDIALOGCONFIG Содержит сведения, используемые для отображения диалогового окна задачи. Функция taskDialogIndirectиспользует эту структуру.