次の方法で共有


タスク ダイアログについて

タスク ダイアログは、情報の表示とユーザーからの単純な入力の受信に使用できるダイアログ ボックスです。 メッセージ ボックスと同様に、ユーザーが設定したパラメーターに従って、オペレーティング システムによって書式設定されます。 ただし、タスク ダイアログには、メッセージ ボックスよりも多くの機能があります。

Note

タスク ダイアログには、シングルスレッド アパートメント (STA) モデルが必要です。

 

タスク ダイアログの一部

タスク ダイアログは複数の要素で構成され、そのほとんどは省略可能です。 次の図は、タスク ダイアログのさまざまな部分を示しています。

screen shot of a window showing various buttons, including one next to collapsed control text

次の図は、折りたたまれたコントロール テキストの横にあるボタンをクリックして、別のテキストがフッターに表示された様子を示しています。

screen shot of the previous window, but with two lines of expanded control text

図には、以下のパーツが示されています。

部分 説明 TASKDIALOGCONFIG メンバー
Window title ウィンドウのキャプション。 pszWindowTitle
メイン アイコン タスク ダイアログの目的を示す大きなアイコン。 hMainIcon または pszMainIcon
主な指示 プリンシパル テキスト。 pszMainInstruction
Content 余分なテキスト。 pszContent
進捗バー タスクの進行状況を示すアニメーション バー。 dwFlags
ラジオ ボタン ユーザーのアプリケーション定義オプション。 pRadioButtons
カスタム ボタン 一般的なボタンの 1 つではないボタン。 これは、通常のボタンでも、図に示すように、最大 2 行のテキストを含むコマンド リンクでもかまいません。 pButtons
展開/折りたたみボタン アプリケーション定義の折りたたまれたコントロール テキスト ([詳細を表示] など) と展開されたコントロール テキストを切り替えるために使用できるボタン。2 行以上に配置できます。 コントロール テキストが展開されると、pszExpandedInformation の追加テキストも、コンテンツ テキストの後、またはフッターに (2 番目の図に示すように) 表示されます。 pszCollapsedControlTextpszExpandedControlText
検証チェック ボックス [このダイアログをもう一度表示しない] などの簡単な選択肢を示す、アプリケーション定義のテキストがあるチェックボックス。 pszVerificationText
フッター アイコン フッター テキストの目的を示す小さなアイコン。 hFooterIcon または pszFooterIcon
フッター テキスト その他のテスト。 図では、テキストにハイパーリンクが含まれています。 pszFooter
共通ボタン 標準ボタン。図では [OK] ボタン。 dwCommonButtons