TDM_UPDATE_ICON訊息

重新整理工作對話方塊的圖示。

參數

wParam [in]

指出要更新的圖示專案。 此參數必須是下列其中一個值：

值	意義
TDIE_ICON_MAIN	主要圖示。
TDIE_ICON_FOOTER	頁尾圖示。

lParam [in]

要顯示之 HICON) (圖示的指標 (PCWSTR) 或控制碼。 如果 lParam 為 Null，則不論 wParam的值為何，都不會顯示任何圖示。

如果wParam的值是TDIE_ICON_MAIN，而且TDF_USE_HICON_MAIN旗標是在用來建立工作對話方塊之TASKDIALOGCONFIG結構的dwFlags成員上設定，lParam必須包含要顯示的圖示控制碼 (HICON) 。

如果wParam的值是TDIE_ICON_FOOTER，且TDF_USE_HICON_FOOTER旗標是在用來建立工作對話方塊之TASKDIALOGCONFIG結構的dwFlags成員上設定，lParam必須包含要顯示之 HICON) (圖示的控制碼。

如果未在dwFlags成員上設定TDF_USE_HICON_MAIN或TDF_USE_HICON_FOOTER旗標，lParam必須指向 null 終止的 Unicode 字串 (PCWSTR) ，其中包含透過MAKEINTRESOURCE宏傳遞的有效資源識別碼。 圖示會根據 wParam的值顯示：如果值TDIE_ICON_MAIN，則圖示會顯示在標頭中;如果值TDIE_ICON_FOOTER，圖示會顯示在頁尾中。 資源必須來自應用程式的資源模組 (在 TASKDIALOGCONFIG結構) 的hInstance成員中指定的，或者如果hInstance是Null，則從系統的資源模組 (imageres.dll) 。 若要識別系統資源，請使用透過 MAKEINTRESOURCE 宏傳遞的有效系統識別碼，或 commctrl.h 中下列其中一個預先定義的值：

值	意義
TD_ERROR_ICON	停止符號圖示。
TD_WARNING_ICON	驚嘆號圖示。
TD_INFORMATION_ICON	圓形圖示中的小寫字母 「i」。
TD_SHIELD_ICON	安全性防護圖示。

傳回值

會忽略傳回值。

備註

具有圖示的工作對話方塊配置可能會失敗，而且可能不會反映在傳回值中。 S_OK的傳回值只會反映工作對話方塊收到訊息並嘗試處理訊息。 如果工作對話方塊的配置失敗，對話方塊將會關閉，並在已註冊的回呼函式傳回 HRESULT 程式碼。 如需回呼函式語法的詳細資訊，請參閱 TaskDialogCallbackProc。

如果建立工作對話方塊時沒有頁尾 (，則用來建立工作對話方塊之 TASKDIALOGCONFIG 結構的適當頁尾成員會是 Null) ，而且傳送此訊息時，不會動態新增頁尾至工作對話方塊。 當建立工作對話方塊而不使用標頭時，傳送此訊息來更新標頭圖示也是如此。 若要在執行時間新增頁首或頁尾，請使用 TDM_NAVIGATE_PAGE 功能。

規格需求