TDM_UPDATE_ICON メッセージ

タスク ダイアログのアイコンを更新します。

パラメーター

wParam [in]

更新するアイコン要素を示します。 このパラメーターは、次のいずれかの値である必要があります。

値	説明
TDIE_ICON_MAIN	メイン アイコン。
TDIE_ICON_FOOTER	フッター アイコン。

lParam [in]

表示する文字列 (PCWSTR) またはアイコン (HICON) へのハンドルへのポインター。 lParam が NULL の場合、wParam の値に関係なくアイコンは表示されません。

wParam の値がTDIE_ICON_MAINされ、タスク ダイアログの作成に使用される TASKDIALOGCONFIG 構造体の dwFlags メンバーにTDF_USE_HICON_MAIN フラグが設定されている場合、lParam にはアイコン (HICON) へのハンドルが含まれている必要があります。

wParam の値がTDIE_ICON_FOOTERされ、タスク ダイアログの作成に使用される TASKDIALOGCONFIG 構造体の dwFlags メンバーにTDF_USE_HICON_FOOTER フラグが設定されている場合、lParam には、表示するアイコン (HICON) へのハンドルが含まれている必要があります。

dwFlags メンバーにTDF_USE_HICON_MAINフラグまたはTDF_USE_HICON_FOOTER フラグが設定されていない場合、lParam は、MAKEINTRESOURCE マクロを介して渡される有効なリソース識別子を含む null で終わる Unicode 文字列 (PCWSTR) を指す必要があります。 アイコンは 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 機能を使用します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
ヘッダー	Commctrl.h