mcpField
S
syncfusion-winforms-xptaskpane

syncfusion-winforms-xptaskpane

github.com/syncfusion开发278 次安装1 周前更新
代码仓库

关于 syncfusion-winforms-xptaskpane

这是一项在 Windows Forms 中使用 Syncfusion XPTaskPane 的参考技能，面向需要组织可导航任务页面的开发者，提供下拉菜单、导航按钮和 Office XP 风格配置。

主要功能

  1. 01创建和管理任务页面
  2. 02通过箭头或下拉菜单导航
  3. 03设置页面顺序和自定义链接
  4. 04应用 OfficeXP 或 Office2007 样式
  5. 05启用页面垂直滚动

适用场景

  1. 01将设置整理为多个分区
  2. 02浏览文档的不同章节
  3. 03按页面归类相关功能
  4. 04构建多步骤工作流

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/syncfusion/winforms-ui-components-skills --skill syncfusion-winforms-xptaskpane

安装后在 Claude Code 中输入/syncfusion-winforms-xptaskpane确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
appearance-styling.md
getting-started.md
navigation-header.md
page-management.md
page-reordering.md
scrolling-content.md

详细介绍

实现 Syncfusion XPTaskPane

XPTaskPane 是一种受 Microsoft Office XP 启发的容器控件，可托管多个任务页，并内置导航和设计时支持。当你需要专业外观的多页布局，并通过下拉菜单和导航按钮浏览页面时，可以使用它。

何时使用 XPTaskPane

在以下情况下使用 XPTaskPane：

  • 创建受 Office XP UI 启发的多页布局
  • 提供多个内容面板之间的导航
  • 允许用户通过下拉菜单或箭头按钮浏览页面
  • 构建可折叠的任务窗格界面
  • 将相关功能组织到不同页面中
  • 为页面提供设计时拖放支持

组件概览

XPTaskPane 包含：

  • XPTaskPane - 主容器控件
  • WizardContainer - 页面容器（自动添加）
  • XPTaskPage - 在窗格中显示的单个页面
  • Header - 包含按钮、菜单和关闭图标的导航工具栏
XPTaskPane (main control)
├── HeaderLeftToolbar (previous/next buttons)
├── HeaderRightToolbar (menu dropdown + close button)
└── TaskPanePageContainer (WizardContainer)
    ├── XPTaskPage 1
    ├── XPTaskPage 2
    └── XPTaskPage N

文档导航指南

入门

📄 阅读： references/getting-started.md

  • 程序集依赖项和 NuGet 安装
  • 通过窗体设计器添加 XPTaskPane
  • 使用代码以编程方式添加 XPTaskPane
  • 创建 WizardContainer 和 XPTaskPage 实例
  • 基本初始化步骤
页面管理

📄 阅读： references/page-management.md

  • 创建并添加 XPTaskPage 实例
  • 配置页面标题和布局名称
  • 向任务页添加控件
  • 访问 TaskPages 集合
  • SelectedPage 属性用法
导航和标头控件

📄 阅读： references/navigation-header.md

  • 标头工具栏组件和项目
  • 导航按钮的可见性和功能
  • 用于选择页面的下拉菜单
  • 自定义标头菜单
  • 配置关闭按钮
  • 为工具栏按钮设置自定义图像
页面重新排序和导航

📄 阅读： references/page-reordering.md

  • 在设计时重新排序页面
  • NextPage 和 PreviousPage 属性
  • 运行时顺序页面导航
  • Bring to Front 和 Send to Back 操作
  • 在集合编辑器中对页面排序
外观和样式

📄 阅读： references/appearance-styling.md

  • 视觉样式（OfficeXP 和 Office2007）
  • 自定义字体和前景色
  • 边框样式和边框属性
  • 标头标签样式
  • 页面级外观配置
  • 自定义颜色和配色方案
内容滚动

📄 阅读： references/scrolling-content.md

  • 启用页面垂直滚动
  • 配置 ScrollSpeed 属性
  • 鼠标悬停时的滚动行为
  • 处理内容溢出

快速入门示例

using Syncfusion.Windows.Forms.Tools;

// Step 1: Create XPTaskPane
XPTaskPane xpTaskPane1 = new XPTaskPane();
this.Controls.Add(xpTaskPane1);

// Step 2: Create and add WizardContainer
WizardContainer wizardContainer1 = new WizardContainer();
xpTaskPane1.Controls.Add(wizardContainer1);
xpTaskPane1.TaskPanePageContainer = wizardContainer1;

// Step 3: Create task pages
XPTaskPage page1 = new XPTaskPage();
page1.Title = "Page 1";
wizardContainer1.Controls.Add(page1);

XPTaskPage page2 = new XPTaskPage();
page2.Title = "Page 2";
wizardContainer1.Controls.Add(page2);

// Step 4: Set pages in TaskPages collection
xpTaskPane1.TaskPages = new XPTaskPage[] { page1, page2 };

// Step 5: Add controls to pages
Button btn = new Button() { Text = "Click Me" };
page1.Controls.Add(btn);

常见模式

模式 1：基于设计器的设置
  1. 从工具箱将 XPTaskPane 拖到窗体上
  2. 在 Smart Tags 中单击“添加页面”
  3. 以可视化方式设计每个页面
  4. 基本设置无需编写代码
模式 2：运行时创建页面
  • 根据数据或条件动态创建页面
  • 使用 TaskPages 属性更新集合
  • 适用于动态布局
模式 3：页面间导航
  • 设置 NextPage 和 PreviousPage 属性
  • 以编程方式定义页面顺序
  • 独立于集合控制顺序
模式 4：自定义样式
  • 将 VisualStyle 设置为 Office2007 或 OfficeXP
  • 全局自定义 Font 和 ForeColor
  • 覆盖单个页面的外观

主要属性一览

属性类型用途
TaskPagesXPTaskPage[]所有任务页的数组
SelectedPageXPTaskPage当前活动页面
TaskPanePageContainerControl页面容器（WizardContainer）
VisualStyleVisualStyleOffice 主题（OfficeXP 或 Office2007）
ScrollSpeedint页面内容的滚动速度
VerticalScrollbool启用垂直滚动
FontFont任务窗格的全局字体
ForeColorColor全局文本颜色
HeaderLabelLabel标题文本控件
HeaderLeftToolbarToolBar上一页／下一页导航按钮
HeaderRightToolbarToolBar菜单和关闭按钮

典型用例

  1. 多步向导 - 创建分步工作流
  2. 设置仪表板 - 将设置整理到逻辑分区中
  3. 文档查看器 - 浏览多个文档章节
  4. 功能浏览器 - 将相关功能分组到不同页面
  5. 任务整理 - 在可折叠页面中显示相关任务

评论

支持 Markdown