CTaskDialog クラス
メッセージ ボックスのような機能を持つだけでなく、ユーザーに対する追加情報も表示できる、ポップアップ ダイアログ ボックスです。 CTaskDialog には、ユーザーから情報を収集するための機能も用意されています。
class CTaskDialog : public CObject
メンバー
コンストラクター
CTaskDialog オブジェクトを構築します。
メソッド
CTaskDialog::AddCommandControl
CTaskDialog にコマンド ボタン コントロールを追加します。
CTaskDialog にオプション ボタンを追加します。
CTaskDialog::ClickCommandControl
コマンド ボタン コントロールまたはコモン ボタンをプログラムからクリックします。
プログラムによってオプション ボタンをクリックします。
CTaskDialog を表示します。
CTaskDialog::GetCommonButtonCount
使用可能なコモン ボタンの数を取得します。
CTaskDialog::GetCommonButtonFlag
標準 Windows ボタンを、CTaskDialog クラスに関連付けられたコモン ボタン型に変換します。
CTaskDialog::GetCommonButtonId
CTaskDialog クラスに関連付けられたコモン ボタン型の 1 つを、標準 Windows ボタンに変換します。
この CTaskDialog のオプション フラグを返します。
CTaskDialog::GetSelectedCommandControlID
選択されたコマンド ボタン コントロールを返します。
CTaskDialog::GetSelectedRadioButtonID
選択されたオプション ボタンを返します。
CTaskDialog::GetVerificationCheckboxState
確認のチェック ボックスの状態を取得します。
CTaskDialog::IsCommandControlEnabled
コマンド ボタン コントロールまたはコモン ボタンが有効かどうかを調べます。
CTaskDialog::IsRadioButtonEnabled
オプション ボタンが有効かどうかを調べます。
アプリケーションが実行されているコンピューターで CTaskDialog がサポートされているかどうかを調べます。
CTaskDialog::LoadCommandControls
ストリング テーブルのデータを使用して、コマンド ボタン コントロールを追加します。
ストリング テーブルのデータを使用して、オプション ボタンを追加します。
フォーカスを別の CTaskDialog に移動します。
CTaskDialog::OnCommandControlClick
ユーザーがコマンド ボタン コントロールをクリックしたときに、フレームワークによってこのメソッドが呼び出されます。
CTaskDialog が作成されると、フレームワークによってこのメソッドが呼び出されます。
CTaskDialog を破棄する直前に、フレームワークによってこのメソッドが呼び出されます。
CTaskDialog::OnExpandButtonClick
ユーザーが展開ボタンをクリックしたときに、フレームワークによってこのメソッドが呼び出されます。
ユーザーがヘルプを表示するときに、フレームワークによってこのメソッドが呼び出されます。
ユーザーがハイパーリンクをクリックしたときに、フレームワークによってこのメソッドが呼び出されます。
CTaskDialog が初期化されたときに、フレームワークによってこのメソッドが呼び出されます。
ユーザーが CTaskDialog 上のコントロールに関連してフォーカスを移動したときに、フレームワークによってこのメソッドが呼び出されます。
CTaskDialog::OnRadioButtonClick
ユーザーがオプション ボタン コントロールをクリックしたときに、フレームワークによってこのメソッドが呼び出されます。
タイマーの時間が経過したときに、フレームワークによってこのメソッドが呼び出されます。
CTaskDialog::OnVerificationCheckboxClick
ユーザーが確認のチェック ボックスをオンまたはオフにしたときに、フレームワークによってこのメソッドが呼び出されます。
CTaskDialog::RemoveAllCommandControls
CTaskDialog のコマンド コントロールをすべて削除します。
CTaskDialog::RemoveAllRadioButtons
CTaskDialog のオプション ボタンをすべて削除します。
CTaskDialog::SetCommandControlOptions
CTaskDialog のコマンド ボタン コントロールを更新します。
CTaskDialog::SetCommonButtonOptions
コモン ボタンのサブセットを更新して有効にし、UAC 昇格を要求します。
CTaskDialog にコモン ボタンを追加します。
CTaskDialog のコンテンツを更新します。
CTaskDialog::SetDefaultCommandControl
既定のコマンド ボタン コントロールを指定します。
CTaskDialog::SetDefaultRadioButton
既定のオプション ボタンを指定します。
CTaskDialog の幅を調整します。
CTaskDialog の展開領域を更新します。
CTaskDialog のフッター アイコンを更新します。
CTaskDialog のフッターのテキストを更新します。
CTaskDialog のメイン アイコンを更新します。
CTaskDialog::SetMainInstruction
CTaskDialog のメインの命令を更新します。
CTaskDialog のオプションを構成します。
CTaskDialog::SetProgressBarMarquee
CTaskDialog のマーキー バーを構成し、それをダイアログ ボックスに追加します。
CTaskDialog::SetProgressBarPosition
プログレス バーの位置を調整します。
CTaskDialog::SetProgressBarRange
プログレス バーの範囲を調整します。
CTaskDialog::SetProgressBarState
プログレス バーの状態を設定し、それを CTaskDialog に表示します。
CTaskDialog::SetRadioButtonOptions
オプション ボタンを有効または無効にします。
CTaskDialog::SetVerificationCheckbox
確認のチェック ボックスをオンの状態に設定します。
CTaskDialog::SetVerificationCheckboxText
確認のチェック ボックスの右側にテキストを設定します。
CTaskDialog のタイトルを設定します。
CTaskDialog を作成して表示します。
CTaskDialog::TaskDialogCallback
さまざまな Windows メッセージへの応答として、フレームワークによって呼び出されます。
データ メンバー
m_aButtons
CTaskDialog 用のコマンド ボタン コントロールの配列。
m_aRadioButtons
CTaskDialog 用のオプション ボタン コントロールの配列。
m_bVerified
確認のチェック ボックスがオンになっている場合は TRUE、オンになっていない場合は FALSE。
m_footerIcon
CTaskDialog のフッター内のアイコン。
m_hWnd
CTaskDialog のウィンドウに対するハンドル。
m_mainIcon
CTaskDialog のメイン アイコン。
m_nButtonDisabled
無効にするコモン ボタンを指定するマスク。
m_nButtonElevation
UAC 昇格を必要とするコモン ボタンを指定するマスク。
m_nButtonId
選択されたコマンド ボタン コントロールの ID。
m_nCommonButton
CTaskDialog に表示されるコモン ボタンを指定するマスク。
m_nDefaultCommandControl
CTaskDialog が表示されるときに選択されるコマンド ボタン コントロールの ID。
m_nDefaultRadioButton
CTaskDialog が表示されるときに選択されるオプション ボタン コントロールの ID。
m_nFlags
CTaskDialog のオプションを指定するマスク。
m_nProgressPos
プログレス バーの現在の位置。 この値の有効値の範囲は m_nProgressRangeMin 〜 m_nProgressRangeMax です。
m_nProgressRangeMax
プログレス バーの最大値。
m_nProgressRangeMin
プログレス バーの最小値。
m_nProgressState
プログレス バーの状態。 詳細については、「CTaskDialog::SetProgressBarState」を参照してください。
m_nRadioId
選択されたオプション ボタン コントロールの ID。
m_nWidth
CTaskDialog の幅 (ピクセル単位)。
m_strCollapse
CTaskDialog で展開された情報が非表示になっているときに展開ボックスの右側に表示される文字列。
m_strContent
CTaskDialog のコンテンツ文字列。
m_strExpand
CTaskDialog で展開された情報が表示されているときに展開ボックスの右側に表示される文字列。
m_strFooter
CTaskDialog のフッター。
m_strInformation
CTaskDialog の展開された情報。
m_strMainInstruction
CTaskDialog のメインの命令。
m_strTitle
CTaskDialog のタイトル。
m_strVerification
CTaskDialog で確認のチェック ボックスの右側に表示される文字列。
解説
CTaskDialog クラスは、標準 Windows メッセージ ボックスに置き換わるものであり、ユーザーから情報を収集する新しいコントロールなどの追加機能を備えています。 このクラスは、Visual Studio 2010 の MFC ライブラリ内にあります。 CTaskDialog を使用できるのは、Windows Vista 以降です。 それより前のバージョンの Windows では、CTaskDialog オブジェクトを表示できません。 現在のユーザーがタスク ダイアログ ボックスを表示できるかどうかを実行時に判別するには、CTaskDialog::IsSupported を使用します。 標準 Windows メッセージ ボックスは、Visual Studio 2010 でも引き続きサポートされています。
CTaskDialog を使用できるのは、Unicode ライブラリを使用してアプリケーションをビルドするときのみです。
CTaskDialog には、2 つのコンストラクターがあります。 1 つのコンストラクターでは、2 個のコマンド ボタンと最大 6 個の標準ボタン コントロールを指定できます。 CTaskDialog の作成後に、さらに多くのコマンド ボタンを追加することができます。 もう 1 つのコンストラクターでは、コマンド ボタンはサポートされていませんが、標準ボタン コントロールを無制限に追加できます。 コンストラクターの詳細については、「CTaskDialog::CTaskDialog」を参照してください。
次の図は、一部のコントロールの位置を示す CTaskDialog のサンプルです。
CTaskDialog のサンプル
CTaskDialog のサンプル
必要条件
**最小オペレーティング システムが必要。**Windows Vista
**ヘッダー:**afxtaskdialog.h
参照
処理手順
チュートリアル: アプリケーションへの CTaskDialog の追加