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

應用程式特定數據的指標。 這是用來建立工作對話框之結構 TASKDIALOGCONFIG 之 lpCallbackData 成員所指向的數據。

傳回值

類型： HRESULT

傳回值專屬於正在處理的通知。 回應按鈕按兩下時，如果 [工作對話框] 未關閉，您的實作應該會傳回S_FALSE。 否則會傳回S_OK。

備註

應用程式必須在透過 TaskDialogIndirect 透過指標傳遞的 TASKDIALOGCONFIG 結構的 pfCallback 成員中傳遞其位址，以註冊此回呼函式。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	commctrl.h (包含 Commctrl.h)