CMFCTasksPane クラス

[アーティクル]
02/21/2013

このトピックは、完全を期すために含まれています。詳細については、Visual Studio のインストールの VC\atlmfc\src\mfc フォルダーにあるソースコードを参照してください。

CMFCTasksPane クラスは、クリック可能な項目 (タスク) のリストを実装します。

class CMFCTasksPane : public CDockablePane

メンバー

パブリックコンストラクター

名前	説明
CMFCTasksPane::CMFCTasksPane	CMFCTasksPane オブジェクトを構築します。

パブリックメソッド

名前	説明
CMFCTasksPane::AddGroup	タスクの新しいグループを作業ウィンドウコントロールに追加します。
CMFCTasksPane::AddLabel	指定したタスクグループに新しい静的ラベルを追加します。
CMFCTasksPane::AddMRUFilesList	MRU ファイルリスト (最近使ったファイルの一覧) に指定されているタスクをグループに追加します。
CMFCTasksPane::AddPage	作業ウィンドウに新しいページを追加します。
CMFCTasksPane::AddSeparator
CMFCTasksPane::AddTask	新しいタスクを指定したタスクグループに追加します。
CMFCTasksPane::AddWindow	作業ウィンドウに子ウィンドウを追加します。
CMFCTasksPane::CollapseAllGroups
CMFCTasksPane::CollapseGroup	プログラムを使用してグループを折りたたみます。
CMFCTasksPane::CreateDefaultMiniframe	(CPane::CreateDefaultMiniframe をオーバーライドします。)
CMFCTasksPane::CreateMenu	[その他の作業ウィンドウ] メニューボタン用のメニューを作成するために、フレームワークによって呼び出されます。
CMFCTasksPane::EnableAnimation	タスクグループの展開または折りたたみ中のアニメーションを有効または無効にします。
CMFCTasksPane::EnableGroupCollapse	タスクグループを折りたたみ可能にするかどうかを指定します。
CMFCTasksPane::EnableHistoryMenuButtons	[次へ] ナビゲーションボタンおよび [戻る] ナビゲーションボタンのドロップダウンメニューを有効または無効にします。
CMFCTasksPane::EnableNavigationToolbar	ナビゲーションツールバーを有効または無効にします。
CMFCTasksPane::EnableOffsetCustomControls
CMFCTasksPane::EnableScrollButtons	スクロールバーではなく、スクロールボタンを有効にします。
CMFCTasksPane::EnableWrapLabels	ラベルのワードラップを有効または無効にします。
CMFCTasksPane::EnableWrapTasks	タスクのワードラップを有効または無効にします。
CMFCTasksPane::GetActivePage	アクティブページの 0 から始まるインデックスを返します。
CMFCTasksPane::GetGroupCaptionHeight	グループキャプションの高さを返します。
CMFCTasksPane::GetGroupCaptionHorzOffset	グループキャプションから作業ウィンドウの左端および右端までの現在のオフセットを返します。
CMFCTasksPane::GetGroupCaptionVertOffset	グループキャプションから作業ウィンドウの上端および下端までの現在のオフセットを返します。
CMFCTasksPane::GetGroupCount	グループの総数を返します。
CMFCTasksPane::GetGroupLocation	指定したグループの内部グループインデックスを返します。
CMFCTasksPane::GetGroupVertOffset	グループの垂直オフセットを返します。
CMFCTasksPane::GetHorzMargin	作業ウィンドウとクライアント領域の端との水平間隔を返します。
CMFCTasksPane::GetNextPages
CMFCTasksPane::GetPageByGroup	指定されたグループのページインデックスを取得します。
CMFCTasksPane::GetPagesCount	ページ数を返します。
CMFCTasksPane::GetPreviousPages
CMFCTasksPane::GetScrollBarCtrl	(CWnd::GetScrollBarCtrl をオーバーライドします。)
CMFCTasksPane::GetTask	タスクを取得します。
CMFCTasksPane::GetTaskCount	指定されたグループ内のタスク項目数を返します。
CMFCTasksPane::GetTaskGroup	指定したグループインデックスに対応するタスクグループを返します。
CMFCTasksPane::GetTaskLocation	指定したタスクのグループとインデックスを返します。
CMFCTasksPane::GetTasksHorzOffset	親グループの左端および右端からタスクまでの水平オフセットを返します。
CMFCTasksPane::GetTasksIconHorzOffset
CMFCTasksPane::GetTasksIconVertOffset
CMFCTasksPane::GetVertMargin	作業ウィンドウとクライアント領域の端との垂直間隔を返します。
CMFCTasksPane::IsAccessibilityCompatible	(CDockablePane::IsAccessibilityCompatible をオーバーライドします。)
CMFCTasksPane::IsAnimationEnabled	アニメーションが有効かどうかを示します。
CMFCTasksPane::IsBackButtonEnabled	[戻る] ボタンが有効かどうかを示します。
CMFCTasksPane::IsForwardButtonEnabled	[進む] ボタンが有効かどうかを示します。
CMFCTasksPane::IsGroupCollapseEnabled
CMFCTasksPane::IsHistoryMenuButtonsEnabled	[次へ] ナビゲーションボタンおよび [戻る] ナビゲーションボタンにドロップダウンメニューがあるかどうかを示します。
CMFCTasksPane::IsNavigationToolbarEnabled	ナビゲーションツールバーが有効かどうかを示します。
CMFCTasksPane::IsToolBox
CMFCTasksPane::IsWrapLabelsEnabled	作業ウィンドウでラベルのテキストが折り返されるかどうかを示します。
CMFCTasksPane::IsWrapTasksEnabled	作業ウィンドウでタスクのテキストが折り返されるかどうかを示します。
CMFCTasksPane::LoadState	(CDockablePane::LoadState をオーバーライドします。)
CMFCTasksPane::OnCancel
CMFCTasksPane::OnClickTask	ユーザーが作業ウィンドウ内の項目をクリックしたときに、フレームワークによって呼び出されます。
CMFCTasksPane::OnOK
CMFCTasksPane::OnPressBackButton	ユーザーが「戻る」ボタンをクリックすると、フレームワークによって呼び出されます。
CMFCTasksPane::OnPressForwardButton	ユーザーが [進む] ナビゲーションボタンをクリックすると、フレームワークによって呼び出されます。
CMFCTasksPane::OnPressHomeButton	ユーザーが [ホーム] ナビゲーションボタンをクリックすると、フレームワークによって呼び出されます。
CMFCTasksPane::OnPressOtherButton
CMFCTasksPane::OnSetAccData	(CBasePane::OnSetAccData をオーバーライドします。)
CMFCTasksPane::OnUpdateCmdUI	(CDockablePane::OnUpdateCmdUI をオーバーライドします。)
CMFCTasksPane::PreTranslateMessage	(CDockablePane::PreTranslateMessage をオーバーライドします。)
CMFCTasksPane::RecalcLayout	(CPane::RecalcLayout をオーバーライドします。)
CMFCTasksPane::RemoveAllGroups	指定したページ上のすべてのグループを削除します。
CMFCTasksPane::RemoveAllPages	既定 (最初) のページを除く、すべてのページを作業ウィンドウから削除します。
CMFCTasksPane::RemoveAllTasks	グループからすべてのタスクを削除します。
CMFCTasksPane::RemoveGroup	グループを削除します。
CMFCTasksPane::RemovePage	指定されたページを作業ウィンドウから削除します。
CMFCTasksPane::RemoveTask	タスクグループからタスクを削除します。
CMFCTasksPane::SaveState	(CDockablePane::SaveState をオーバーライドします。)
CMFCTasksPane::Serialize	(CDockablePane::Serialize をオーバーライドします。)
CMFCTasksPane::SetActivePage	作業ウィンドウの指定されたページをアクティブにします。
CMFCTasksPane::SetCaption	作業ウィンドウのキャプション名を設定します。
CMFCTasksPane::SetGroupCaptionHeight	グループキャプションの高さを設定します。
CMFCTasksPane::SetGroupCaptionHorzOffset	グループキャプションの水平オフセットを設定します。
CMFCTasksPane::SetGroupCaptionVertOffset	グループキャプションの垂直オフセットを設定します。
CMFCTasksPane::SetGroupName	グループ名を設定します。
CMFCTasksPane::SetGroupTextColor	グループキャプションのテキストの色を設定します。
CMFCTasksPane::SetGroupVertOffset	グループの垂直オフセットを設定します。
CMFCTasksPane::SetHorzMargin	作業ウィンドウとクライアント領域の端との水平間隔を設定します。
CMFCTasksPane::SetIconsList	タスクに関連付けられたイメージリストを設定します。
CMFCTasksPane::SetPageCaption	作業ウィンドウページのキャプションテキストを設定します。
CMFCTasksPane::SetTaskName	タスクの名前を設定します。
CMFCTasksPane::SetTasksIconHorzOffset
CMFCTasksPane::SetTasksIconVertOffset
CMFCTasksPane::SetTaskTextColor	タスクのテキストの色を設定します。
CMFCTasksPane::SetTasksHorzOffset	親グループの左端および右端からタスクまでの現在の水平オフセットを設定します。
CMFCTasksPane::SetVertMargin	作業ウィンドウとクライアント領域の端との垂直間隔を設定します。
CMFCTasksPane::SetWindowHeight	ウィンドウの高さを設定します。
CMFCTasksPane::ShowCommandMessageString
CMFCTasksPane::ShowTask	タスクの表示と非表示を切り替えます。
CMFCTasksPane::ShowTaskByCmdId	コマンド ID に基づいて、タスクの表示と非表示を切り替えます。
CMFCTasksPane::Update	作業ウィンドウに属する GUI 要素を更新します。

プロテクトメソッド

名前	説明
CMFCTasksPane::OnActivateTasksPanePage	新しい作業ウィンドウページがアクティブになると、フレームワークによって呼び出されます。

解説

CMFCTasksPane クラスは次の機能を実装します。

項目をグループ化し、項目の各グループにキャプションを関連付けることができます。
項目グループは展開したり、折りたたんだりできます。
作業ウィンドウの各項目にアイコンを関連付けることができます。
個々の項目をコマンド ID に関連付けることができます。このコマンド ID は、ユーザーが項目をクリックすると実行されます。クリックされると、WM_COMMAND メッセージが作業ウィンドウコントロールのオーナーに送信されます。

アプリケーションで CMFCTasksPane コントロールを使用するには、次の手順に従います。

CMFCTasksPane オブジェクトをメインフレームウィンドウクラスに埋め込みます。
WM_CREATE メッセージを処理するときは、Create メソッドを呼び出します。標準の CControlBar スタイルを使用できます。詳細については、「CControlBar::Create」を参照してください。
CMFCTasksPane::AddGroup メソッドを呼び出して、さまざまなグループを追加します。
CMFCTasksPane::AddTask、CMFCTasksPane::AddLabel、または CMFCTasksPane::AddMRUFilesList の各メンバー関数を使用して、新しい項目 (タスク) を各グループに追加します。
CMFCTasksPane::EnableGroupCollapse を呼び出して、項目グループを折りたためるかどうかを指定します。

次の図は、標準的な作業ウィンドウコントロールを示しています。最初のグループは特殊グループで、キャプションは濃い色で表示されます。3 番目のグループは折りたたまれています。最後のグループは作業ウィンドウの最下部に揃えられており、キャプションはなく、グループの最後のタスクは単純なラベルです。

作業ウィンドウの例

作業ウィンドウの外観をカスタマイズするには、さまざまなマージンやオフセットを調整します。次の図には、そのための変数の意味が示されています。

カスタムタスクグループ

使用例

CMFCTasksPane オブジェクトを構築して CMFCTasksPane クラスのさまざまなメソッドを使用する方法を次の例に示します。この例は、タスクグループの折りたたみを有効にする方法、[次へ] ナビゲーションボタンと [戻る] ナビゲーションボタンのドロップダウンメニューを有効にする方法、スクロールバーの代わりにスクロールボタンを有効にする方法、ラベルのテキストのワードラップを有効にする方法、作業ウィンドウのキャプション名を設定する方法、グループキャプションのテキストの色を設定する方法、および水平マージンと垂直マージンを設定する方法が示されています。

    CMFCTasksPane* tPane = new CMFCTasksPane();
    tPane->EnableGroupCollapse(true);
    tPane->EnableHistoryMenuButtons(true);
    tPane->EnableScrollButtons(true);
    tPane->EnableWrapLabels(true);
    tPane->SetCaption(_T("Task Pane"));
    tPane->SetGroupTextColor(0,RGB(0,0,128));
    tPane->SetHorzMargin(15);
    tPane->SetVertMargin(15);
    tPane->Update();

継承階層

CObject CCmdTarget CWnd

CBasePane CPane CDockablePane

CMFCTasksPane

必要条件

ヘッダー : afxTasksPane.h

参照

その他の技術情報

MFC クラス

次の方法で共有

CMFCTasksPane クラス

メンバー

パブリックコンストラクター

パブリックメソッド

プロテクトメソッド

解説

使用例

継承階層

必要条件

参照

関連項目

その他の技術情報

その他のリソース

次の方法で共有

CMFCTasksPane クラス

メンバー

パブリック コンストラクター

パブリック メソッド

プロテクト メソッド

解説

使用例

継承階層

必要条件

参照

関連項目

その他の技術情報

その他のリソース

パブリックコンストラクター

パブリックメソッド

プロテクトメソッド