タスクダイアログ

[アーティクル]
03/18/2024

このセクションでは、タスクダイアログで使用されるプログラミング要素について説明します。 タスクダイアログは、基本的なメッセージボックスよりもはるかに柔軟ですが、似ています。

概要

トピック	内容
タスクダイアログについて	タスクダイアログの要素について説明します。

関数

トピック	内容
TaskDialog	タスクダイアログを作成、表示、および操作します。タスクダイアログには、アプリケーション定義のメッセージテキストとタイトル、アイコン、および定義済みのプッシュボタンの任意の組み合わせが含まれます。この関数は、通知を受信するコールバック関数の登録をサポートしていません。
TaskDialogCallbackProc	TaskDialogIndirect 関数で使用されるアプリケーション定義関数。さまざまなイベントが発生すると、タスクダイアログからメッセージを受信します。 PFTASKDIALOGCALLBACK 型は、このコールバック関数へのポインターを定義します。 TaskDialogCallbackProc は、アプリケーション定義関数名のプレースホルダーです。
TaskDialogIndirect	タスクダイアログを作成、表示、および操作します。タスクダイアログには、アプリケーション定義のアイコン、メッセージ、タイトル、検証チェックボックス、コマンドリンク、プッシュボタン、ラジオボタンが含まれています。この関数は、通知メッセージを受信するコールバック関数を登録できます。

[メッセージ]

トピック	内容
TDM_CLICK_BUTTON	タスクダイアログ内のボタンクリックのアクションをシミュレートします。
TDM_CLICK_RADIO_BUTTON	タスクダイアログ内のラジオボタンクリックのアクションをシミュレートします。
TDM_CLICK_VERIFICATION	タスクダイアログ内の検証チェックボックスクリックのアクションをシミュレートします。
TDM_ENABLE_BUTTON	タスクダイアログのプッシュボタンを有効または無効にします。
TDM_ENABLE_RADIO_BUTTON	タスクダイアログのラジオボタンを有効または無効にします。
TDM_NAVIGATE_PAGE	タスクダイアログを新しい内容で再作成し、マルチページウィザードの機能をシミュレートします。
TDM_SET_BUTTON_ELEVATION_REQUIRED_STATE	特定のタスクダイアログボタンまたはコマンドリンクに User Account Control (UAC) シールドアイコンを設定するかどうかを指定します。つまり、ボタンによって呼び出されたアクションが海抜を必要とするかどうかです。
TDM_SET_ELEMENT_TEXT	タスクダイアログでテキスト要素を更新します。
TDM_SET_MARQUEE_PROGRESS_BAR	ホストされている進行状況バーをマーキーモードで表示するかどうかを示します。
TDM_SET_PROGRESS_BAR_MARQUEE	進行状況バーのマーキー表示を開始および停止し、マーキーの速度を設定します。
TDM_SET_PROGRESS_BAR_POS	進行状況バーの現在位置を設定します。
TDM_SET_PROGRESS_BAR_RANGE	ホストされた進行状況バーの最小値と最大値を設定します。
TDM_SET_PROGRESS_BAR_STATE	進行状況バーの現在の状態を設定します。
TDM_UPDATE_ELEMENT_TEXT	タスクダイアログでテキスト要素を更新します。
TDM_UPDATE_ICON	タスクダイアログのアイコンを更新します。

通知

トピック	内容
TDN_BUTTON_CLICKED	ユーザーがタスクダイアログでボタンまたはコマンドリンクを選択したときに、タスクダイアログが送信します。この通知コードは、TaskDialogIndirect メソッドを使用して登録できるタスクダイアログコールバック関数を介してのみ受信されます。
TDN_CREATED	タスクダイアログが作成された後、および表示される前に、タスクダイアログが送信します。この通知コードは、TaskDialogIndirect メソッドを使用して登録できるタスクダイアログコールバック関数を介してのみ受信されます。
TDN_DESTROYED	タスクダイアログが破棄され、そのウィンドウハンドルが無効になったときに送信されます。この通知コードは、TaskDialogIndirect メソッドを使用して登録できるタスクダイアログコールバック関数を介してのみ受信されます。
TDN_DIALOG_CONSTRUCTED	タスクダイアログが作成された後、および表示される前に、タスクダイアログが送信します。この通知コードは、TaskDialogIndirect メソッドを使用して登録できるタスクダイアログコールバック関数を介してのみ受信されます。
TDN_EXPANDO_BUTTON_CLICKED	ユーザーがタスクダイアログの [展開] ボタンをクリックしたときに、タスクダイアログが送信します。この通知コードは、TaskDialogIndirect メソッドを使用して登録できるタスクダイアログコールバック関数を介してのみ受信されます。
TDN_HELP	タスクダイアログにフォーカスがあるときに、ユーザーがキーボードの F1 キーを押すと、タスクダイアログが送信します。この通知コードは、TaskDialogIndirect メソッドを使用して登録できるタスクダイアログコールバック関数を介してのみ受信されます。
TDN_HYPERLINK_CLICKED	ユーザーがタスクダイアログのコンテンツ内のハイパーリンクをクリックしたときに、タスクダイアログが送信します。この通知コードは、TaskDialogIndirect メソッドを使用して登録できるタスクダイアログコールバック関数を介してのみ受信されます。
TDN_NAVIGATED	ナビゲーションが発生したときにタスクダイアログが送信します。この通知コードは、TaskDialogIndirect メソッドを使用して登録できるタスクダイアログコールバック関数を介してのみ受信されます。
TDN_RADIO_BUTTON_CLICKED	ユーザーがタスクダイアログでボタンまたはコマンドリンクを選択したときに、タスクダイアログが送信します。この通知コードは、TaskDialogIndirect メソッドを使用して登録できるタスクダイアログコールバック関数を介してのみ受信されます。
TDN_TIMER	約 200 ミリ秒ごとにタスクダイアログが送信します。この通知コードは、TDF_CALLBACK_TIMER フラグが、TaskDialogIndirect 関数に渡された TASKDIALOGCONFIG 構造体の dwFlags メンバーに設定されている際に送信されます。この通知コードは、TaskDialogIndirect メソッドを使用して登録できるタスクダイアログコールバック関数を介してのみ受信されます。
TDN_VERIFICATION_CLICKED	ユーザーがタスクダイアログの検証チェックボックスをクリックしたときに、タスクダイアログが送信します。この通知コードは、TaskDialogIndirect メソッドを使用して登録できるタスクダイアログコールバック関数を介してのみ受信されます。

構造体

トピック	内容
TASKDIALOG_BUTTON	タスクダイアログにボタンを表示するために使用する情報が含まれます。 TASKDIALOGCONFIG 構造体では、この構造体が使用されます。
TASKDIALOGCONFIG	タスクダイアログの表示に使用する情報が含まれます。 TaskDialogIndirect 関数は、この構造体を使用します。