CMFCTasksPane选件类
添加本主题是为了让内容更加完整。有关更多信息，请参见所安装的 Visual Studio 的 VC\atlmfc\src\mfc 文件夹中的源代码。
CMFCTasksPane 选件类实现列表的项(任务）。
class CMFCTasksPane : public CDockablePane
成员
.gif "Bb984027.collapse_all(zh-cn,VS.110).gif")
公共构造函数
名称 |
说明 |
|---|---|
构造 CMFCTasksPane 对象。 |
公共方法
名称 |
说明 |
|---|---|
添加任务的新组添加到任务窗格控件。 |
|
添加新的静态标签。指定的任务组。 |
|
添加新使用的(MRU)文件中指定的任务列表添加到组。 |
|
将新页面添加到任务窗格。 |
|
|
|
将新任务添加到指定的任务组。 |
|
添加子窗口到任务窗格。 |
|
|
|
以编程方式折叠组。 |
|
调用由框架创建 其他任务窗格 菜单按钮的一个菜单。 |
|
启用或禁用动画，当折叠或展开任务组时。 |
|
指定任务组是否可以折叠。 |
|
启用或禁用了 接下来 和 以前 导航按钮的下拉菜单。 |
|
启用或禁用导航工具栏。 |
|
|
|
启用滚动按钮而不是滚动条。 |
|
启用或禁用包装用于标签的单词。 |
|
启用或禁用包装为任务的单词。 |
|
返回到活动页的从零开始的索引。 |
|
返回组说明的高度。 |
|
返回一个组的说明的当前偏移量任务窗格的左右边缘。 |
|
返回一个组的说明的当前偏移量任务窗格的上下的。 |
|
返回组的总数。 |
|
返回一组给定的内部组索引。 |
|
返回组的垂直偏移量。 |
|
返回在任务窗格和工作区的边缘之间的水平间距。 |
|
|
|
检索页索引指定的组。 |
|
返回页的数量。 |
|
|
|
（重写 CWnd::GetScrollBarCtrl。） |
|
检索任务。 |
|
在指定的组中返回的任务项目。 |
|
返回一组给定索引是任务组。 |
|
返回组和索引特定任务的。 |
|
将水平的偏移量从其父组左右边缘的任务。 |
|
|
|
|
|
返回在任务窗格和工作区的边缘之间的垂直间距。 |
|
（重写 CDockablePane::IsAccessibilityCompatible。） |
|
指示动画是否启用。 |
|
指示后退按钮是否启用。 |
|
指示前进按钮是否启用。 |
|
|
|
指示 接下来 和 以前 导航按钮是否具有下拉菜单。 |
|
指示导航工具栏是否启用。 |
|
|
|
指示任务窗格是否包装在标签的单词。 |
|
指示任务窗格是否包装在任务的单词。 |
|
|
|
调用由结构，当用户单击任务窗格的项目。 |
|
|
|
调用由结构，当用户单击"后退"按钮。 |
|
调用由结构，当用户单击向前导航按钮。 |
|
调用由结构，当用户单击国内导航按钮 |
|
|
|
（重写 CBasePane::OnSetAccData。） |
|
（重写 installutil.exe 工具。） |
|
移除指定的页的所有组。 |
|
从除默认(第一个)页的任务窗格中移除所有页。 |
|
从的组中移除所有任务。 |
|
移除组。 |
|
从任务窗格中移除指定的页。 |
|
从任务组移除任务。 |
|
（重写 CDockablePane:: 序列化。） |
|
激活在任务窗格中指定的页。 |
|
设置任务窗格的声明名称。 |
|
设置组说明的高度。 |
|
设置组标题的水平扭曲。 |
|
设置组说明的垂直偏移量。 |
|
设置组名称。 |
|
设置组说明的文本颜色。 |
|
设置组的垂直偏移量。 |
|
将任务窗格和工作区的边缘之间的水平间距。 |
|
设置图像列表与任务。 |
|
设置任务窗格页的标题文本。 |
|
设置名称任务。 |
|
|
|
|
|
设置任务的文本颜色。 |
|
设置水平的偏移量从其父组左右边缘的任务。 |
|
将任务窗格和工作区的边缘之间的垂直间距。 |
|
设置窗口的高度。 |
|
|
|
显示或隐藏任务。 |
|
显示或隐藏根据其命令ID.的任务 |
|
更新属于任务窗格的GUI元素。 |
受保护的方法
名称 |
说明 |
|---|---|
调用由结构，当激活新任务窗格页。 |
备注
CMFCTasksPane 选件类实现以下功能:
可以分组项目，并且每项分组可以有一个关联的说明。
项目分组可以折叠或展开。
图标可分配到任务窗格的每个项。
各个项可与执行的命令ID当用户单击该项。当单击时，WM_COMMAND 发送到任务窗格控件的所有者。
若要使用 CMFCTasksPane 控件在您的应用程序，请执行以下步骤:
嵌入一 CMFCTasksPane 对象向主框架窗口选件类。
在处理 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