Функция обратного вызова 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) |