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

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

Обзоры

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

Функции

Тема	Содержание
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использует эту структуру.