CMFCTasksPaneTaskGroup Class

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at CMFCTasksPaneTaskGroup Class.

The CMFCTasksPaneTaskGroup class is a helper class used by the CMFCTasksPane control. Objects of type CMFCTasksPaneTaskGroup represent a task group. The task group is a list of items that the framework displays in a separate box that has a collapse button. The box can have an optional caption (group name). If a group is collapsed, the list of tasks is not visible.

class CMFCTasksPaneTaskGroup : public CObject  

Public Constructors

NameDescription
CMFCTasksPaneTaskGroup::CMFCTasksPaneTaskGroupConstructs a CMFCTasksPaneTaskGroup object.
CMFCTasksPaneTaskGroup::~CMFCTasksPaneTaskGroupDestructor.

Public Methods

NameDescription
CMFCTasksPaneTaskGroup::SetACCDataDetermines the accessibility data for the current task group.

Data Members

NameDescription
CMFCTasksPaneTaskGroup::m_bIsBottomDetermines whether the task group is aligned to the bottom of the task pane control.
CMFCTasksPaneTaskGroup::m_bIsCollapsedDetermines whether the task group is collapsed.
CMFCTasksPaneTaskGroup::m_bIsSpecialDetermines whether the task group is special. The framework displays special captions in a different color.
CMFCTasksPaneTaskGroup::m_lstTasksContains the internal list of tasks.
CMFCTasksPaneTaskGroup::m_rectSpecifies the bounding rectangle of the group caption.
CMFCTasksPaneTaskGroup::m_rectGroupSpecifies the bounding rectangle of the group.
CMFCTasksPaneTaskGroup::m_strNameSpecifies the name of the group.

The following illustration shows an expanded task group:

Task group, expanded

The following illustration shows a collapsed task group:

Collapsed task group

The following illustration shows a task group without a caption:

Task group without a caption

The following illustration shows two task groups. The first task group is marked as special by setting the m_bIsSpecial flag to TRUE, while the second task group is not special. Note how the caption for the first task group is darker than the second task group:

Special task group

CObject

CMFCTasksPaneTaskGroup

Header: afxTasksPane.h

Constructs a CMFCTasksPaneTaskGroup object.

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

Parameters

lpszName
Specifies the name of the group in the group caption.

bIsBottom
Specifies whether the group is aligned to the bottom of the task pane control.

bIsSpecial
Specifies whether the group is designated as special and thus, whether the group caption is filled with a different color.

bIsCollapsed
Specifies whether the group is collapsed.

pPage
Specifies the property page that this task group belongs to.

hIcon
Specifies the icon that displays in the group caption.

Remarks

Determines whether the task group is aligned to the bottom of the task pane control.

BOOL m_bIsBottom;  

Remarks

Only one group can be aligned to the bottom of the task pane control. This task group must be added last. For more information, see CMFCTasksPane::AddGroup.

Determines whether the task group is collapsed.

BOOL m_bIsCollapsed;  

Remarks

You can enable or disable the ability to collapse groups on the task pane by calling CMFCTasksPane::EnableGroupCollapse.

Determines whether the task group is special and whether the caption for a special task group should be identified by a different color.

BOOL m_bIsSpecial;  

Remarks

If your application is using the Windows XP visual theme and m_bIsSpecial is FALSE, the framework calls DrawThemeBackground with the EBP_NORMALGROUPBACKGROUND flag. If m_bIsSpecial is TRUE, the framework calls DrawThemeBackground with the EBP_SPECIALGROUPBACKGROUND flag.

Contains the internal list of tasks.

CObList m_lstTasks;  

Remarks

To fill this list, call CMFCTasksPane::AddTask.

Specifies the bounding rectangle of the group caption.

CRect m_rect;  

Remarks

This value is automatically calculated by the framework.

Specifies the bounding rectangle of the group.

CRect m_rectGroup;  

Remarks

This value is calculated automatically by the framework.

Specifies the name of the group.

CString m_strName;  

Remarks

If this value is empty, the group caption is not displayed and the group cannot be collapsed.

Determines the accessibility data for the current task group.

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

Parameters

[in] pParent
Represents the parent window of the current task group.

[out] data
An object of type CAccessibilityData that is populated with the accessibility data of the current task group.

Return Value

TRUE if the data parameter was successfully populated with the accessibility data of the current task group; otherwise, FALSE.

Hierarchy Chart
Classes
CMFCTasksPane Class
CMFCTasksPaneTask Class
CMFCOutlookBar Class
CObject Class

Show: