CMFCTasksPane Class

Article
11/16/2012

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

The CMFCTasksPane class implements a list of clickable items (tasks).

class CMFCTasksPane : public CDockablePane

Members

Public Constructors

Name	Description
CMFCTasksPane::CMFCTasksPane	Constructs a CMFCTasksPane object.

Public Methods

Name	Description
CMFCTasksPane::AddGroup	Adds a new group of tasks to the task pane control.
CMFCTasksPane::AddLabel	Adds a new static label into the specified task group.
CMFCTasksPane::AddMRUFilesList	Adds tasks specified by a Most Recently Used (MRU) file list into a group.
CMFCTasksPane::AddPage	Adds a new page to the task pane.
CMFCTasksPane::AddSeparator
CMFCTasksPane::AddTask	Adds a new task to the specified task group.
CMFCTasksPane::AddWindow	Adds a child window to the task pane.
CMFCTasksPane::CollapseAllGroups
CMFCTasksPane::CollapseGroup	Programmatically collapses a group.
CMFCTasksPane::CreateDefaultMiniframe	(Overrides CPane::CreateDefaultMiniframe.)
CMFCTasksPane::CreateMenu	Called by the framework to create a menu for the Other Tasks Panes menu button.
CMFCTasksPane::EnableAnimation	Enables or disables animation while collapsing or expanding task groups.
CMFCTasksPane::EnableGroupCollapse	Specifies whether tasks groups can be collapsed.
CMFCTasksPane::EnableHistoryMenuButtons	Enables or disables drop-down menus in Next and Previous navigation buttons.
CMFCTasksPane::EnableNavigationToolbar	Enables or disables the navigation toolbar.
CMFCTasksPane::EnableOffsetCustomControls
CMFCTasksPane::EnableScrollButtons	Enables scroll buttons instead of a scrollbar.
CMFCTasksPane::EnableWrapLabels	Enables or disables word wrapping for labels.
CMFCTasksPane::EnableWrapTasks	Enables or disables word wrapping for tasks.
CMFCTasksPane::GetActivePage	Returns the zero-based index for the active page.
CMFCTasksPane::GetGroupCaptionHeight	Returns the height of the group captions.
CMFCTasksPane::GetGroupCaptionHorzOffset	Returns the current offset of a group caption from the left and right edges of the task pane.
CMFCTasksPane::GetGroupCaptionVertOffset	Returns the current offset of a group caption from the top and bottom edges of the task pane.
CMFCTasksPane::GetGroupCount	Returns the total number of groups.
CMFCTasksPane::GetGroupLocation	Returns the internal group index for a given group.
CMFCTasksPane::GetGroupVertOffset	Returns the vertical offset of a group.
CMFCTasksPane::GetHorzMargin	Returns the horizontal spacing between a task pane and the edges of the client area.
CMFCTasksPane::GetNextPages
CMFCTasksPane::GetPageByGroup	Retrieves the page index for a specified group.
CMFCTasksPane::GetPagesCount	Returns the number of pages.
CMFCTasksPane::GetPreviousPages
CMFCTasksPane::GetScrollBarCtrl	(Overrides CWnd::GetScrollBarCtrl.)
CMFCTasksPane::GetTask	Retrieves a task.
CMFCTasksPane::GetTaskCount	Returns the number of task items in a specified group.
CMFCTasksPane::GetTaskGroup	Returns a task group for a given group index.
CMFCTasksPane::GetTaskLocation	Returns the group and the index for a given task.
CMFCTasksPane::GetTasksHorzOffset	Returns the horizontal offset of tasks from the left and right edges of their parent groups.
CMFCTasksPane::GetTasksIconHorzOffset
CMFCTasksPane::GetTasksIconVertOffset
CMFCTasksPane::GetVertMargin	Returns the vertical spacing between a task pane and the edges of the client area.
CMFCTasksPane::IsAccessibilityCompatible	(Overrides CDockablePane::IsAccessibilityCompatible.)
CMFCTasksPane::IsAnimationEnabled	Indicates whether animation is enabled.
CMFCTasksPane::IsBackButtonEnabled	Indicates whether the back button is enabled.
CMFCTasksPane::IsForwardButtonEnabled	Indicates whether the forward button is enabled.
CMFCTasksPane::IsGroupCollapseEnabled
CMFCTasksPane::IsHistoryMenuButtonsEnabled	Indicates whether the Next and Previous navigation buttons have drop-down menus.
CMFCTasksPane::IsNavigationToolbarEnabled	Indicates whether the navigation toolbar is enabled.
CMFCTasksPane::IsToolBox
CMFCTasksPane::IsWrapLabelsEnabled	Indicates whether the task pane wraps words in labels.
CMFCTasksPane::IsWrapTasksEnabled	Indicates whether the task pane wraps words in tasks.
CMFCTasksPane::LoadState	(Overrides CDockablePane::LoadState.)
CMFCTasksPane::OnCancel
CMFCTasksPane::OnClickTask	Called by the framework when the user clicks an item in the task pane.
CMFCTasksPane::OnOK
CMFCTasksPane::OnPressBackButton	Called by the framework when the user clicks the back button.
CMFCTasksPane::OnPressForwardButton	Called by the framework when the user clicks the forward navigation button.
CMFCTasksPane::OnPressHomeButton	Called by the framework when the user clicks the home navigation button
CMFCTasksPane::OnPressOtherButton
CMFCTasksPane::OnSetAccData	(Overrides CBasePane::OnSetAccData.)
CMFCTasksPane::OnUpdateCmdUI	(Overrides CDockablePane::OnUpdateCmdUI.)
CMFCTasksPane::PreTranslateMessage	(Overrides CDockablePane::PreTranslateMessage.)
CMFCTasksPane::RecalcLayout	(Overrides CPane::RecalcLayout.)
CMFCTasksPane::RemoveAllGroups	Removes all groups on the specified page.
CMFCTasksPane::RemoveAllPages	Removes all pages from the task pane except the default (first) page.
CMFCTasksPane::RemoveAllTasks	Removes all tasks from the group.
CMFCTasksPane::RemoveGroup	Removes a group.
CMFCTasksPane::RemovePage	Removes a specified page from the task pane.
CMFCTasksPane::RemoveTask	Removes a task from a task group.
CMFCTasksPane::SaveState	(Overrides CDockablePane::SaveState.)
CMFCTasksPane::Serialize	(Overrides CDockablePane::Serialize.)
CMFCTasksPane::SetActivePage	Activates a specified page in the task pane.
CMFCTasksPane::SetCaption	Sets the caption name of a task pane.
CMFCTasksPane::SetGroupCaptionHeight	Sets the height of a group caption.
CMFCTasksPane::SetGroupCaptionHorzOffset	Sets the horizontal offset of a group caption.
CMFCTasksPane::SetGroupCaptionVertOffset	Sets the vertical offset of a group caption.
CMFCTasksPane::SetGroupName	Sets a group name.
CMFCTasksPane::SetGroupTextColor	Sets the text color for a group caption.
CMFCTasksPane::SetGroupVertOffset	Sets the vertical offset for a group.
CMFCTasksPane::SetHorzMargin	Sets the horizontal spacing between a task pane and the edges of the client area.
CMFCTasksPane::SetIconsList	Sets the image list associated with tasks.
CMFCTasksPane::SetPageCaption	Sets the caption text for a task pane page.
CMFCTasksPane::SetTaskName	Sets the name for a task.
CMFCTasksPane::SetTasksIconHorzOffset
CMFCTasksPane::SetTasksIconVertOffset
CMFCTasksPane::SetTaskTextColor	Sets the text color for a task.
CMFCTasksPane::SetTasksHorzOffset	Sets the horizontal offset of tasks from the left and right edges of their parent groups.
CMFCTasksPane::SetVertMargin	Sets the vertical spacing between a task pane and the edges of the client area.
CMFCTasksPane::SetWindowHeight	Sets the height for a window.
CMFCTasksPane::ShowCommandMessageString
CMFCTasksPane::ShowTask	Shows or hides a task.
CMFCTasksPane::ShowTaskByCmdId	Shows or hides a task based on its command ID.
CMFCTasksPane::Update	Updates the GUI elements that belong to a task pane.

Protected Methods

Name	Description
CMFCTasksPane::OnActivateTasksPanePage	Called by the framework when a new task pane page is activated.

Remarks

The CMFCTasksPane class implements the following functionality:

Items can be grouped and each item grouping can have an associated caption.
Item groupings can be collapsed or expanded.
An icon can be assigned to each item in the task pane.
Individual items can be associated with a command ID which executes when a user clicks the item. When the click occurs, the WM_COMMAND message is sent to the owner of the task pane control.

To use the CMFCTasksPane control in your application, follow these steps:

Embed a CMFCTasksPane object into the main frame window class.
When processing the WM_CREATE message, call the Create method. You can use the regular CControlBar styles. For more information, see CControlBar::Create.
Call the CMFCTasksPane::AddGroup method to add various groups.
Call the CMFCTasksPane::AddTask, CMFCTasksPane::AddLabel or CMFCTasksPane::AddMRUFilesList member functions to add new items (tasks) to each group.
Call CMFCTasksPane::EnableGroupCollapse to specify whether item groups can collapse.

The following illustration shows a typical task pane control. The first group is a special group and its caption is a darker color. The third group is collapsed. The last group is aligned to the bottom of the task pane and has no caption, and the last task in the group is a simple label:

Task Pane Example

You can customize the appearance of the task pane by adjusting various margins and offsets. The following illustration clarifies the meaning of these variables:

Custom task group

Example

The following example demonstrates how to construct a CMFCTasksPane object and use various methods in the CMFCTasksPane class. The example shows how to enable the collapsing of task groups, enable the drop-down menus on the Next and Previous navigation buttons, enable the scroll buttons instead of a scroll bar, enable the word wrapping for the text in labels, set the caption name of the task pane, set the text color for a group caption, and set the horizontal and vertical margins.

    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();

Inheritance Hierarchy

CObject CCmdTarget CWnd

CBasePane CPane CDockablePane

CMFCTasksPane

Requirements

Header: afxTasksPane.h

CMFCTasksPane Class

Members

Public Constructors

Public Methods

Protected Methods

Remarks

Example

Inheritance Hierarchy

Requirements

See Also

Concepts

Reference

Other Resources

Additional resources