CMFCTasksPaneTaskGroup 類別

發行項
10/12/2023

類別 CMFCTasksPaneTaskGroup 是 CMFCTasksPane 控制項所使用的協助程式類別。屬於類型 CMFCTasksPaneTaskGroup 的物件表示「 工作群組」(Task Group)。工作群組是 Framework 顯示在具有摺疊按鈕之不同方塊中的項目清單。方塊可以有選擇性的標題 (群組名稱)。如果群組已摺疊，工作清單是不可見的。

語法

class CMFCTasksPaneTaskGroup : public CObject

成員

公用建構函式

名稱	描述
CMFCTasksPaneTaskGroup：：CMFCTasksPaneTaskGroup	建構 `CMFCTasksPaneTaskGroup` 物件。
`CMFCTasksPaneTaskGroup::~CMFCTasksPaneTaskGroup`	解構函式。

公用方法

名稱	描述
CMFCTasksPaneTaskGroup：：SetACCData	決定目前工作組的協助工具資料。

資料成員

名稱	描述
CMFCTasksPaneTaskGroup：：m_bIsBottom	判斷工作組是否對齊工作窗格控制項底部。
CMFCTasksPaneTaskGroup：：m_bIsCollapsed	判斷工作組是否折迭。
CMFCTasksPaneTaskGroup：：m_bIsSpecial	判斷工作組是否特別。架構會以不同色彩顯示特殊標題。
CMFCTasksPaneTaskGroup：：m_lstTasks	包含工作的內部清單。
CMFCTasksPaneTaskGroup：：m_rect	指定群組的周框標題。
CMFCTasksPaneTaskGroup：：m_rectGroup	指定群組的周框。
CMFCTasksPaneTaskGroup：：m_strName	指定群組的名稱。

備註

下圖顯示展開的工作組：

Task group, expanded.

下圖顯示折迭的工作組：

Collapsed task group.

下圖顯示沒有標題的工作群組：

Task group without a caption.

下圖顯示兩個工作組。第一個工作組會藉由將 m_bIsSpecial 旗標設定為 TRUE 來標示為特殊，而第二個工作組則不是特殊。請注意，第一個工作組的標題比第二個工作組暗：

Special task group.

繼承階層架構

CObject

CMFCTasksPaneTaskGroup

需求

標頭： afxTasksPane.h

CMFCTasksPaneTaskGroup：：CMFCTasksPaneTaskGroup

建構 CMFCTasksPaneTaskGroup 物件。

CMFCTasksPaneTaskGroup(
    LPCTSTR lpszName,
    BOOL bIsBottom,
    BOOL bIsSpecial=FALSE,
    BOOL bIsCollapsed=FALSE,
    CMFCTasksPanePropertyPage* pPage=NULL,
    HICON hIcon=NULL);

參數

lpszName
指定群組中群組的名稱標題。

bIsBottom
指定群組是否對齊工作窗格控制項底部。

bIsSpecial
指定群組是否指定為特殊群組，因此，群組標題是否填滿不同的色彩。

bIsCollapsed
指定群組是否折迭。

pPage
指定這個工作組所屬的屬性頁。

hIcon
指定在群組標題中顯示的圖示。

備註

CMFCTasksPaneTaskGroup：：m_bIsBottom

判斷工作組是否對齊工作窗格控制項底部。

BOOL m_bIsBottom;

備註

只有一個群組可以對齊工作窗格控制項的底部。此工作組必須最後新增。如需詳細資訊，請參閱 CMFCTasksPane：：AddGroup 。

CMFCTasksPaneTaskGroup：：m_bIsCollapsed

判斷工作組是否折迭。

BOOL m_bIsCollapsed;

備註

您可以藉由呼叫 CMFCTasksPane：：EnableGroupCollapse 來啟用或停用折迭工作窗格上的群組的能力。

CMFCTasksPaneTaskGroup：：m_bIsSpecial

判斷工作組是否特別，以及特殊工作組的標題是否應該以不同的色彩來識別。

BOOL m_bIsSpecial;

備註

如果您的應用程式使用 Windows XP 視覺主題且 m_bIsSpecial 為 FALSE，則架構會使用 EBP_NORMALGROUPBACKGROUND 旗標呼叫 DrawThemeBackground 。如果 m_bIsSpecial 為 TRUE，架構會使用 EBP_SPECIALGROUPBACKGROUND 旗標呼叫 DrawThemeBackground 。

CMFCTasksPaneTaskGroup：：m_lstTasks

包含工作的內部清單。

CObList m_lstTasks;

備註

若要填入此清單，請呼叫 CMFCTasksPane：：AddTask 。

CMFCTasksPaneTaskGroup：：m_rect

指定群組的周框標題。

CRect m_rect;

備註

這個值是由架構自動計算。

CMFCTasksPaneTaskGroup：：m_rectGroup

指定群組的周框。

CRect m_rectGroup;

備註

這個值是由架構自動計算。

CMFCTasksPaneTaskGroup：：m_strName

指定群組的名稱。

CString m_strName;

備註

如果此值是空的，則不會顯示群組標題，且無法折迭群組。

CMFCTasksPaneTaskGroup：：SetACCData

決定目前工作組的協助工具資料。

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

參數

pParent
[in]表示目前工作組的父視窗。

data
[out]型 CAccessibilityData 別的物件，會填入目前工作組的協助工具資料。

傳回值

如果資料參數已成功填入目前工作組的協助工具資料，則為 TRUE，否則為 FALSE。

另請參閱

階層架構圖表
 類別
 CMFCTasksPane 類別
 CMFCTasksPaneTask 類別
 CMFCOutlookBar 類別
 CObject 類別

共用方式為