SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场syncfusion-winforms-tab-splitter-container

syncfusion-winforms-tab-splitter-container

前端与建站

查看项目

更新于 10-16 02:49

技能介绍

用途

TabSplitterContainer（Syncfusion.Windows.Forms.Tools.TabSplitterContainer）是 Syncfusion WinForms UI 组件中的分栏视图布局控件，提供 Visual Studio 2008 风格的选项卡分组分栏视图，便于用户渲染同一文档的不同视图。适用于代码编辑器与预览窗格、设计/代码分栏视图，以及任何多视图文档界面。

主要能力

  • 主页面与次页面：通过 PrimaryPages 和 SecondaryPages 两个集合管理选项卡页面。
  • 交换功能：内置交换按钮，可交换主/次选项卡分组，对应 Swapped 属性。
  • 折叠/展开：内置折叠按钮，可隐藏或显示次窗格，对应 Collapsed 属性。
  • 双方向布局：支持水平（并排）或垂直（上下）布局，对应 Orientation 属性。
  • 可调分隔条：可拖动分隔条调整窗格大小，通过 SplitterPosition 属性控制位置。
  • Office2016 主题：支持 Colorful、White、DarkGray、Black 主题，通过 Style 属性设置。
  • TabSplitterPage：页面可自定义文本、图像、工具提示、边框样式、背景图像和可见性。
  • 设计时支持：与可视化设计器集成，支持智能标记。

关键命名空间：Syncfusion.Windows.Forms.Tools；程序集：Syncfusion.Tools.Windows.dll（及依赖项）。

使用方式

可通过设计器（工具箱 + 智能标记）或代码添加 TabSplitterContainer。基本步骤为：创建 TabSplitterContainer 实例并设置 Dock；创建 TabSplitterPage 实例并设置 Text 等属性；将页面分别加入 PrimaryPages 和 SecondaryPages 集合；最后将控件添加到窗体。

示例（代码）：

using Syncfusion.Windows.Forms.Tools;

TabSplitterContainer splitterContainer = new TabSplitterContainer();
splitterContainer.Dock = DockStyle.Fill;

TabSplitterPage xamlPage = new TabSplitterPage();
xamlPage.Text = "XAML";
xamlPage.BackColor = Color.White;

TabSplitterPage designPage = new TabSplitterPage();
designPage.Text = "Design";
designPage.BackColor = Color.White;

splitterContainer.PrimaryPages.Add(xamlPage);
splitterContainer.SecondaryPages.Add(designPage);

this.Controls.Add(splitterContainer);

垂直分栏与 Office2016 主题示例：

splitterContainer.Orientation = Orientation.Vertical;
splitterContainer.Style = TabSplitterContainerStyle.Office2016Colorful;
splitterContainer.SplitterPosition = splitterContainer.Height / 2;

关键属性

核心属性：PrimaryPages（主选项卡页面集合）、SecondaryPages（次选项卡页面集合）、Orientation（水平或垂直分栏）、SplitterPosition（分隔条位置，像素）、Collapsed（折叠/展开次窗格）、Swapped（交换主/次选项卡分组）。

样式属性：Style（视觉样式，Default 或 Office2016 变体）、SplitterBackColor（分隔条背景色）。

TabSplitterPage 属性：Text（选项卡文本/标题）、Image（选项卡图标）、ToolTip（悬停提示）、BorderStyle（页面边框样式）、BackgroundImage（页面背景图像）、Visible（页面可见性）。

适用场景

  • 代码编辑器与预览窗格：如 Markdown 编辑器、HTML 编辑器等带实时预览的编辑器。
  • Visual Studio 风格文档编辑器：多文档 IDE，主选项卡组放文档，次选项卡组放属性/输出等。
  • 文档查看器与缩略图：主页面放文档查看器，次页面放缩略图面板。
  • 数据录入表单与帮助窗格：主页面放表单，次页面放上下文帮助，默认折叠。
  • 多语言编辑器：多个 TabSplitterPage 对应不同语言视图，使用交换功能切换。
  • 报表设计器：主页面放报表定义编辑器，次页面放报表预览渲染。

限制

资料未提供该控件的收费、价格、平台兼容性、性能指标或具体事件列表等细节，这些内容暂未提供。事件方面仅说明存在组件状态变化相关事件，详细事件文档需参阅 advanced-features.md。