CMFCTasksPane 類別
本主題是為完整說明而加的。如需詳細資訊，請參閱位於 Visual Studio 安裝位置之 VC\atlmfc\src\mfc 資料夾中的原始程式碼。
CMFCTasksPane 類別實作可按項目 (工作) 的清單。
class CMFCTasksPane : public CDockablePane
Members
.gif "Bb984027.collapse_all(zh-tw,VS.110).gif")
公用建構函式
名稱 |
描述 |
|---|---|
建構 CMFCTasksPane 物件。 |
公用方法
名稱 |
描述 |
|---|---|
加入工作的新群組為工作窗格控制項。 |
|
加入新的靜態標籤置於指定的工作群組。 |
|
將 (MRU) 最近使用的檔案清單中指定的工作項目群組。 |
|
將新頁面加入至工作窗格。 |
|
|
|
將新工作加入至指定之工作群組。 |
|
將子視窗至工作窗格。 |
|
|
|
以程式設計方式摺疊群組。 |
|
呼叫由架構建立 [其他工作窗格] 功能表按鈕的功能表。 |
|
啟用或停用動畫，當展開或摺疊的工作群組時。 |
|
指定工作群組是否可以摺疊。 |
|
啟用或停用在 [下一個] 和 [上一個] 巡覽按鈕的下拉式功能表。 |
|
啟用或停用巡覽工具列。 |
|
|
|
啟用捲軸按鈕而非捲軸。 |
|
啟用或包裝為標籤中停用文字。 |
|
啟用或包裝在工作中停用文字。 |
|
傳回使用中頁面的以零起始的索引。 |
|
傳回群組標題的高度。 |
|
傳回一組標頭的目前位移從工作窗格的左邊緣。 |
|
傳回一組標頭的目前位移從工作窗格上下邊緣的。 |
|
傳回群組物件的總數。 |
|
傳回所指定群組的內部群組指數。 |
|
傳回群組物件的垂直位移。 |
|
傳回在工作窗格和工作區邊緣之間的水平間距。 |
|
|
|
擷取頁面索引指定群組。 |
|
傳回的頁數。 |
|
|
|
(覆寫 CWnd::GetScrollBarCtrl)。 |
|
擷取工作。 |
|
傳回工作數目在指定之群組的項目。 |
|
傳回指定的群組指數的一個工作群組。 |
|
傳回群組和索引所指定的工作。 |
|
傳回水平位移會從其父群組左右邊緣的工作。 |
|
|
|
|
|
傳回在工作窗格和工作區邊緣之間的垂直間距。 |
|
(覆寫 CDockablePane::IsAccessibilityCompatible)。 |
|
指出是否已啟用。 |
|
表示上一頁按鈕是否已啟用。 |
|
表示下一頁按鈕是否已啟用。 |
|
|
|
表示 [下一個] 和 [上一個] 巡覽按鈕是否有下拉式功能表。 |
|
表示巡覽工具列是否已啟用。 |
|
|
|
表示工作窗格是否包裝在標籤的文字。 |
|
表示工作窗格是否包裝在工作中的文字。 |
|
(覆寫 CDockablePane::LoadState)。 |
|
|
|
呼叫框架，當使用者按一下工作窗格中的項目。 |
|
|
|
呼叫框架，當使用者按一下 [上一頁按鈕。 |
|
呼叫框架，當使用者按一下向前巡覽按鈕。 |
|
呼叫框架，當使用者按一下按鈕) 內巡覽 |
|
|
|
(覆寫 CBasePane::OnSetAccData)。 |
|
(覆寫 CPane::RecalcLayout)。 |
|
移除指定之頁面上的任何群組。 |
|
除了預設 (從第一個) 頁面的工作窗格移除所有頁面。 |
|
從的群組移除所有工作。 |
|
移除群組。 |
|
從 工作窗格移除指定的頁面。 |
|
從工作群組中移除工作。 |
|
(覆寫 CDockablePane::SaveState)。 |
|
(覆寫 CDockablePane::Serialize)。 |
|
啟動在工作窗格中所指定的頁面。 |
|
設定工作窗格的標頭名稱。 |
|
設定群組頁首的高度。 |
|
設定群組標題的水平位移。 |
|
設定群組頁首的垂直位移。 |
|
設定群組名稱。 |
|
設定群組標題的文字色彩。 |
|
設定群組的垂直位移。 |
|
將工作窗格和工作區邊緣之間的水平間距。 |
|
設定影像清單與工作。 |
|
設定工作窗格頁面的標題文字。 |
|
設定名稱工作。 |
|
|
|
|
|
設定工作的文字色彩。 |
|
設定水平位移會從其父群組左右邊緣的工作。 |
|
將工作窗格和工作區邊緣之間的垂直間距。 |
|
設定視窗的高度。 |
|
|
|
顯示或隱藏工作。 |
|
顯示或隱藏根據它的命令 ID. 的工作 |
|
更新屬於工作窗格的 GUI 項目。 |
受保護的方法
名稱 |
描述 |
|---|---|
呼叫框架，而且新工作窗格上啟動。 |
備註
CMFCTasksPane 類別實作了下列功能:
可以將項目群組，而且每個項目群組可以有相關聯的標頭。
項目群組可以展開或摺疊的。
圖示可以指派給在工作窗格中的每個項目。
個別項目可以與執行的命令 ID，當使用者按一下項目。 當按一下時， WM_COMMAND 訊息傳送給工作窗格控制項的擁有人。
若要使用 CMFCTasksPane 控制項在應用程式中，依照下列步驟執行:
將一 CMFCTasksPane 物件到主框架視窗 (Frame Window) 類別。
在處理 WM_CREATE 訊息時，請呼叫方法。 Create 您可以使用規則 CControlBar 樣式。 如需詳細資訊，請參閱 CControlBar::Create。
呼叫方法 CMFCTasksPane::AddGroup 加入不同的群組。
呼叫 CMFCTasksPane::AddTask、 CMFCTasksPane::AddLabel 或 CMFCTasksPane::AddMRUFilesList 成員函式加入新項目 (工作) 加入至每個群組。
呼叫 CMFCTasksPane::EnableGroupCollapse 指定項目群組是否可以摺疊。
下圖顯示一般工作窗格控制項。 第一個群組是特定群組，而且其標題是一個深色。 第三個群組摺疊。 最後一個群組對齊至工作窗格底部並沒有標題，則會傳回，而最後一個工作群組中是一個簡單的標籤:
.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