Функция обратного вызова PFTASKDIALOGCALLBACK (commctrl.h)

Функция TaskDialogCallbackProc — это определяемая приложением функция, используемая с функцией TaskDialogIndirect . Он получает сообщения из диалогового окна задачи при возникновении различных событий.

Тип PFTASKDIALOGCALLBACK определяет указатель на эту функцию обратного вызова. TaskDialogCallbackProc — это заполнитель для имени определяемой приложением функции.

Синтаксис

PFTASKDIALOGCALLBACK Pftaskdialogcallback;

HRESULT Pftaskdialogcallback(
  [in] HWND hwnd,
  [in] UINT msg,
  [in] WPARAM wParam,
  [in] LPARAM lParam,
       LONG_PTR lpRefData
)
{...}

Параметры

[in] hwnd

Тип: HWND

Выполните обработку в окне TaskDialog. Не продолжайте отправлять сообщения в hwnd после того, как процедура обратного вызова возвращается из вызова с TDN_DESTROYED.

[in] msg

Тип: UINT

Одно из следующих уведомлений.

Уведомление	Использование
TDN_BUTTON_CLICKED	Указывает, что выбрана кнопка. Идентификатор команды кнопки задается wParam.
TDN_CREATED	Указывает, что диалоговое окно задачи создано.
TDN_DESTROYED	Указывает, что диалоговое окно задачи было уничтожено.
TDN_DIALOG_CONSTRUCTED	Указывает, что диалоговое окно задачи создано, но еще не отображается.
TDN_EXPANDO_BUTTON_CLICKED	Указывает, что кнопка развертывания была выбрана.
TDN_HELP	Указывает, что клавиша F1 была нажата во время фокуса диалогового окна задачи.
TDN_HYPERLINK_CLICKED	Указывает, что выбрана гиперссылка. Указатель на текст ссылки задается с помощью lParam.
TDN_NAVIGATED	Указывает, что произошла навигация.
TDN_RADIO_BUTTON_CLICKED	Указывает, что выбран переключатель. Идентификатор команды переключателя задается wParam.
TDN_TIMER	Указывает, что сработал таймер диалогового окна задачи. Общее затраченное время задается wParam. Индикатор выполнения можно обновить, отправив TDM_SET_PROGRESS_BAR_POS сообщение в окно, указанное параметром hwnd .
TDN_VERIFICATION_CLICKED	Указывает, что выбрано проверка проверки диалогового окна задачи.

[in] wParam

Тип: WPARAM

Указывает дополнительные сведения об уведомлении. Содержимое этого параметра зависит от значения параметра uNotification .

[in] lParam

Тип: LPARAM

Указывает дополнительные сведения об уведомлении. Содержимое этого параметра зависит от значения параметра uNotification .

lpRefData

Тип: LONG_PTR

Указатель на данные конкретного приложения. Это данные, на которые указывает элемент lpCallbackData структуры TASKDIALOGCONFIG , используемый для создания диалогового окна задачи.

Возвращаемое значение

Тип: HRESULT

Возвращаемое значение зависит от обрабатываемого уведомления. При ответе на нажатие кнопки реализация должна возвращать S_FALSE, если диалоговое окно задачи не должно закрываться. В противном случае верните S_OK.

Комментарии

Приложение должно зарегистрировать эту функцию обратного вызова, передав ее адрес в члене pfCallback структуры TASKDIALOGCONFIG , который передается через указатель через TaskDialogIndirect.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	commctrl.h (включая Commctrl.h)