タスク ダイアログについて
タスク ダイアログは、情報の表示とユーザーからの単純な入力の受信に使用できるダイアログ ボックスです。 メッセージ ボックスと同様に、ユーザーが設定したパラメーターに従って、オペレーティング システムによって書式設定されます。 ただし、タスク ダイアログには、メッセージ ボックスよりも多くの機能があります。
Note
タスク ダイアログには、シングルスレッド アパートメント (STA) モデルが必要です。
タスク ダイアログの一部
タスク ダイアログは複数の要素で構成され、そのほとんどは省略可能です。 次の図は、タスク ダイアログのさまざまな部分を示しています。
次の図は、折りたたまれたコントロール テキストの横にあるボタンをクリックして、別のテキストがフッターに表示された様子を示しています。
図には、以下のパーツが示されています。
| 部分 | 説明 | TASKDIALOGCONFIG メンバー |
|---|---|---|
| Window title | ウィンドウのキャプション。 | pszWindowTitle |
| メイン アイコン | タスク ダイアログの目的を示す大きなアイコン。 | hMainIcon または pszMainIcon |
| 主な指示 | プリンシパル テキスト。 | pszMainInstruction |
| Content | 余分なテキスト。 | pszContent |
| 進捗バー | タスクの進行状況を示すアニメーション バー。 | dwFlags |
| ラジオ ボタン | ユーザーのアプリケーション定義オプション。 | pRadioButtons |
| カスタム ボタン | 一般的なボタンの 1 つではないボタン。 これは、通常のボタンでも、図に示すように、最大 2 行のテキストを含むコマンド リンクでもかまいません。 | pButtons |
| 展開/折りたたみボタン | アプリケーション定義の折りたたまれたコントロール テキスト ([詳細を表示] など) と展開されたコントロール テキストを切り替えるために使用できるボタン。2 行以上に配置できます。 コントロール テキストが展開されると、pszExpandedInformation の追加テキストも、コンテンツ テキストの後、またはフッターに (2 番目の図に示すように) 表示されます。 | pszCollapsedControlText と pszExpandedControlText |
| 検証チェック ボックス | [このダイアログをもう一度表示しない] などの簡単な選択肢を示す、アプリケーション定義のテキストがあるチェックボックス。 | pszVerificationText |
| フッター アイコン | フッター テキストの目的を示す小さなアイコン。 | hFooterIcon または pszFooterIcon |
| フッター テキスト | その他のテスト。 図では、テキストにハイパーリンクが含まれています。 | pszFooter |
| 共通ボタン | 標準ボタン。図では [OK] ボタン。 | dwCommonButtons |