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

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

Общие сведения

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

Функции

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

Сообщения

Раздел	Содержимое
TDM_CLICK_BUTTON	Имитирует действие нажатия кнопки в диалоговом окне задачи.
TDM_CLICK_RADIO_BUTTON	Имитирует действие переключателя в диалоговом окне задачи.
TDM_CLICK_VERIFICATION	Имитирует действие проверка box проверки в диалоговом окне задачи.
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	Обновляет значок диалогового окна задачи.

Notifications

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