CMFCTasksPane クラス
更新 : 2007 年 11 月
このトピックは作成中です。
CMFCTasksPane クラスは、クリック可能な項目 (タスク) のリストを実装します。
class CMFCTasksPane : public CDockablePane
メンバ
パブリック コンストラクタ
名前 |
説明 |
|---|---|
CMFCTasksPane オブジェクトを構築します。 |
パブリック メソッド
名前 |
説明 |
|---|---|
タスクの新しいグループを作業ウィンドウ コントロールに追加します。 |
|
指定したタスク グループに新しい静的ラベルを追加します。 |
|
MRU ファイル リスト (最近使ったファイルの一覧) に指定されているタスクをグループに追加します。 |
|
作業ウィンドウに新しいページを追加します。 |
|
|
|
新しいタスクを指定したタスク グループに追加します。 |
|
作業ウィンドウに子ウィンドウを追加します。 |
|
|
|
プログラムを使用してグループを折りたたみます。 |
|
(CPane::CreateDefaultMiniframe をオーバーライドします。) |
|
[その他の作業ウィンドウ] メニュー ボタン用のメニューを作成するために、フレームワークによって呼び出されます。 |
|
タスク グループの展開または折りたたみ中のアニメーションを有効または無効にします。 |
|
タスク グループを折りたたみ可能にするかどうかを指定します。 |
|
[次へ] ナビゲーション ボタンおよび [戻る] ナビゲーション ボタンのドロップダウン メニューを有効または無効にします。 |
|
ナビゲーション ツール バーを有効または無効にします。 |
|
|
|
スクロール バーではなく、スクロール ボタンを有効にします。 |
|
ラベルのワード ラップを有効または無効にします。 |
|
タスクのワード ラップを有効または無効にします。 |
|
アクティブ ページの 0 から始まるインデックスを返します。 |
|
グループ キャプションの高さを返します。 |
|
グループ キャプションから作業ウィンドウの左端および右端までの現在のオフセットを返します。 |
|
グループ キャプションから作業ウィンドウの上端および下端までの現在のオフセットを返します。 |
|
グループの総数を返します。 |
|
指定したグループの内部グループ インデックスを返します。 |
|
グループの垂直オフセットを返します。 |
|
作業ウィンドウとクライアント領域の端との水平間隔を返します。 |
|
|
|
指定されたグループのページ インデックスを取得します。 |
|
ページ数を返します。 |
|
|
|
(CWnd::GetScrollBarCtrl をオーバーライドします。) |
|
タスクを取得します。 |
|
指定されたグループ内のタスク項目数を返します。 |
|
指定したグループ インデックスに対応するタスク グループを返します。 |
|
指定したタスクのグループとインデックスを返します。 |
|
親グループの左端および右端からタスクまでの水平オフセットを返します。 |
|
|
|
|
|
作業ウィンドウとクライアント領域の端との垂直間隔を返します。 |
|
(CDockablePane::IsAccessibilityCompatible をオーバーライドします。) |
|
アニメーションが有効かどうかを示します。 |
|
[戻る] ボタンが有効かどうかを示します。 |
|
[進む] ボタンが有効かどうかを示します。 |
|
|
|
[次へ] ナビゲーション ボタンおよび [戻る] ナビゲーション ボタンにドロップダウン メニューがあるかどうかを示します。 |
|
ナビゲーション ツール バーが有効かどうかを示します。 |
|
|
|
作業ウィンドウでラベルのテキストが折り返されるかどうかを示します。 |
|
作業ウィンドウでタスクのテキストが折り返されるかどうかを示します。 |
|
(CDockablePane::LoadState をオーバーライドします。) |
|
|
|
ユーザーが作業ウィンドウ内の項目をクリックしたときに、フレームワークによって呼び出されます。 |
|
|
|
ユーザーが「戻る」ボタンをクリックすると、フレームワークによって呼び出されます。 |
|
ユーザーが [進む] ナビゲーション ボタンをクリックすると、フレームワークによって呼び出されます。 |
|
ユーザーが [ホーム] ナビゲーション ボタンをクリックすると、フレームワークによって呼び出されます。 |
|
|
|
(CBasePane::OnSetAccData をオーバーライドします。) |
|
(CDockablePane::OnUpdateCmdUI をオーバーライドします。) |
|
(CDockablePane::PreTranslateMessage をオーバーライドします。) |
|
(CPane::RecalcLayout をオーバーライドします。) |
|
指定したページ上のすべてのグループを削除します。 |
|
既定 (最初) のページを除く、すべてのページを作業ウィンドウから削除します。 |
|
グループからすべてのタスクを削除します。 |
|
グループを削除します。 |
|
指定されたページを作業ウィンドウから削除します。 |
|
タスク グループからタスクを削除します。 |
|
(CDockablePane::SaveState をオーバーライドします。) |
|
(CDockablePane::Serialize をオーバーライドします。) |
|
作業ウィンドウの指定されたページをアクティブにします。 |
|
作業ウィンドウのキャプション名を設定します。 |
|
グループ キャプションの高さを設定します。 |
|
グループ キャプションの水平オフセットを設定します。 |
|
グループ キャプションの垂直オフセットを設定します。 |
|
グループ名を設定します。 |
|
グループ キャプションのテキストの色を設定します。 |
|
グループの垂直オフセットを設定します。 |
|
作業ウィンドウとクライアント領域の端との水平間隔を設定します。 |
|
タスクに関連付けられたイメージ リストを設定します。 |
|
作業ウィンドウ ページのキャプション テキストを設定します。 |
|
タスクの名前を設定します。 |
|
|
|
|
|
タスクのテキストの色を設定します。 |
|
親グループの左端および右端からタスクまでの現在の水平オフセットを設定します。 |
|
作業ウィンドウとクライアント領域の端との垂直間隔を設定します。 |
|
ウィンドウの高さを設定します。 |
|
|
|
タスクの表示と非表示を切り替えます。 |
|
コマンド ID に基づいて、タスクの表示と非表示を切り替えます。 |
|
作業ウィンドウに属する GUI 要素を更新します。 |
プロテクト メソッド
名前 |
説明 |
|---|---|
新しい作業ウィンドウ ページがアクティブになると、フレームワークによって呼び出されます。 |
解説
CMFCTasksPane クラスは次の機能を実装します。
項目をグループ化し、項目の各グループにキャプションを関連付けることができます。
項目グループは展開したり、折りたたんだりできます。
作業ウィンドウの各項目にアイコンを関連付けることができます。
個々の項目をコマンド ID に関連付けることができます。このコマンド ID は、ユーザーが項目をクリックすると実行されます。クリックされると、WM_COMMAND メッセージが作業ウィンドウ コントロールのオーナーに送信されます。
アプリケーションで CMFCTasksPane コントロールを使用するには、次の手順に従います。
CMFCTasksPane オブジェクトをメイン フレーム ウィンドウ クラスに埋め込みます。
WM_CREATE メッセージを処理するときは、Create メソッドを呼び出します。標準の CControlBar スタイルを使用できます。詳細については、「CControlBar::Create」を参照してください。
CMFCTasksPane::AddGroup メソッドを呼び出して、さまざまなグループを追加します。
CMFCTasksPane::AddTask、CMFCTasksPane::AddLabel、または CMFCTasksPane::AddMRUFilesList の各メンバ関数を使用して、新しい項目 (タスク) を各グループに追加します。
CMFCTasksPane::EnableGroupCollapse を呼び出して、項目グループを折りたためるかどうかを指定します。
次の図は、標準的な作業ウィンドウ コントロールを示しています。最初のグループは特殊グループで、キャプションは濃い色で表示されます。3 番目のグループは折りたたまれています。最後のグループは作業ウィンドウの最下部に揃えられており、キャプションはなく、グループの最後のタスクは単純なラベルです。
.png "作業ウィンドウの例")
作業ウィンドウの外観をカスタマイズするには、さまざまなマージンやオフセットを調整します。次の図には、そのための変数の意味が示されています。
.png "カスタム タスク グループ")
使用例
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();
継承階層
必要条件
ヘッダー : afxTasksPane.h