CMFCTasksPaneTaskGroup 类

项目
10/14/2023

CMFCTasksPaneTaskGroup 类是由 CMFCTasksPane 控件使用的帮助程序类。 CMFCTasksPaneTaskGroup 类型的对象表示一个任务组。任务组是框架在具有折叠按钮的单独框中显示的项列表。此框可具有一个可选标题（组名）。如果一个组处于折叠状态，则任务列表不可见。

语法

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	指定组的名称。

注解

下图显示一个展开的任务组：

任务组，展开。

下图显示一个折叠的任务组：

折叠的任务组。

下图显示没有标题的任务组：

没有标题的任务组。

下图显示了两个任务组。第一个任务组通过将 m_bIsSpecial 标志设置为 TRUE 来标记为特殊，而第二个任务组不是特殊组。请注意，第一个任务组的标题比第二个任务组的颜色要深：

特殊任务组。

继承层次结构

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 类型的对象，该对象使用当前任务组的辅助功能区数据进行填充。

返回值

如果 data 参数已成功填充当前任务组的辅助功能数据，则为 TRUE；否则为 FALSE。

另请参阅

层次结构图
 类
 CMFCTasksPane 类
 CMFCTasksPaneTask 类
 CMFCOutlookBar 类
 CObject 类

通过