syncfusion-winforms-excel-like-tabbar-splitter

实现 TabBarSplitterControl

在 Windows Forms 应用程序中实现 Syncfusion 的 TabBarSplitterControl 指南。此控件可创建带动态分隔条的选项卡页面，呈现类似工作簿的外观，非常适合与 GridControl 集成以及构建多工作表界面。

何时使用此技能

在以下情况下使用 TabBarSplitterControl：

• 在 Windows Forms 中创建带动态分隔条的选项卡式界面
• 构建包含多个页面的工作簿式 UI 布局
• 将 GridControl 集成到选项卡页面中
• 实现多工作表数据视图
• 创建类似 Excel 的选项卡式界面
• 将多个数据网格组织到不同页面中
• 支持公式单元格和跨工作表引用
• 构建需要通过页面和控件进行导航的应用程序

组件概览

TabBarSplitterControl 可创建带动态分隔条的选项卡页面。与 GridControl 搭配使用时，它可呈现类似工作簿的外观，每个选项卡都可以包含独立的网格实例。

主要功能：

• 支持多个 TabBarPage
• 动态分隔条功能
• 与 GridControl 集成
• 类似工作簿的外观
• 支持通过设计器创建和以编程方式创建
• 每个页面都有控件集合
• 页面管理和组织

程序集： Syncfusion.Shared.Base

命名空间： Syncfusion.Windows.Forms

主要类：

• TabBarSplitterControl - 主容器控件
• TabBarPage - 控件中的单个页面

文档与导航指南

开始使用

📄 阅读： references/getting-started.md

• NuGet 包安装（TabBarSplitterControl 对应的 Syncfusion.Shared.Base）
• 子控件 NuGet 包（参阅 skills 文件夹中子控件的技能文件）
• 程序集和命名空间引用
• 控件基本概览和用途
• 何时使用 TabBarSplitterControl
• 子控件集成基础（GridControl、SfDataGrid 或任何 Syncfusion/框架控件）
• 关于设计器支持的说明

编程实现

📄 阅读： references/programmatic-implementation.md

• 在代码中创建 TabBarSplitterControl
• 初始化和配置 TabBarPage
• 以编程方式向页面添加控件
• 设置页面属性（Text、Controls）
• 多页面场景
• C# 和 VB.NET 实现示例
• GridControl 集成模式
• 常见配置模式

快速入门

安装

TabBarSplitterControl NuGet 包：

安装 Syncfusion.Shared.Base NuGet 包（最新版本）：

Install-Package Syncfusion.Shared.Base -Version *

或者通过 .NET CLI：

dotnet add package Syncfusion.Shared.Base --version *

注意： 使用 * 可确保还原时安装最新版本。

子控件 NuGet 包：

将 TabBarSplitterControl 与子控件（GridControl、SfDataGrid 或任何 Syncfusion/框架控件）搭配使用时，请安装这些子控件所需的 NuGet 包。有关具体的 NuGet 包安装说明，请参阅 skills 文件夹中子控件的 references/getting-started.md 文件。

示例：

• 对于 GridControl：查看 syncfusion-winforms-grid-control/references/getting-started.md 了解 NuGet 安装说明
• 对于 SfDataGrid：查看 syncfusion-winforms-datagrid/references/getting-started.md 了解 NuGet 安装说明
• 对于任何其他控件：查看 syncfusion-winforms-{control-name}/references/getting-started.md 了解 NuGet 安装说明

基本实现（C#）

using Syncfusion.Windows.Forms;
using Syncfusion.Windows.Forms.Grid;

// Create TabBarSplitterControl
TabBarSplitterControl tabBarSplitter = new TabBarSplitterControl();

// Create TabBarPages
TabBarPage page1 = new TabBarPage();
page1.Text = "Sheet1";

TabBarPage page2 = new TabBarPage();
page2.Text = "Sheet2";

// Add GridControls to pages
page1.Controls.Add(new GridControl());
page2.Controls.Add(new GridControl());

// Add pages to TabBarSplitterControl
tabBarSplitter.Controls.Add(page1);
tabBarSplitter.Controls.Add(page2);

// Add to form
this.Controls.Add(tabBarSplitter);

基本实现（VB.NET）

Imports Syncfusion.Windows.Forms
Imports Syncfusion.Windows.Forms.Grid

' Create TabBarPages
Dim page1 As New TabBarPage()
page1.Text = "Sheet1"

Dim page2 As New TabBarPage()
page2.Text = "Sheet2"

' Add GridControls to pages
page1.Controls.Add(New GridControl())
page2.Controls.Add(New GridControl())

' Add pages to TabBarSplitterControl
tabBarSplitterControl1.Controls.Add(page1)
tabBarSplitterControl1.Controls.Add(page2)

常见模式

模式 1：创建多个命名页面

// Initialize TabBarSplitterControl
TabBarSplitterControl tabBarSplitter = new TabBarSplitterControl();

// Create multiple pages with descriptive names
TabBarPage income = new TabBarPage { Text = "Income" };
TabBarPage expenses = new TabBarPage { Text = "Expenses" };
TabBarPage summary = new TabBarPage { Text = "Summary" };

// Add GridControl to each page
income.Controls.Add(new GridControl());
expenses.Controls.Add(new GridControl());
summary.Controls.Add(new GridControl());

// Add all pages to control
tabBarSplitter.Controls.Add(income);
tabBarSplitter.Controls.Add(expenses);
tabBarSplitter.Controls.Add(summary);

// Add to form
this.Controls.Add(tabBarSplitter);

模式 2：使用现有的 GridControl 实例

// Assume you have pre-configured GridControls
GridControl gridIncome = new GridControl();
GridControl gridExpenses = new GridControl();

// Configure grids (add data, formulas, etc.)
// ... grid configuration code ...

// Create pages
TabBarPage incomePage = new TabBarPage { Text = "Income" };
TabBarPage expensesPage = new TabBarPage { Text = "Expenses" };

// Add existing grids to pages
incomePage.Controls.Add(gridIncome);
expensesPage.Controls.Add(gridExpenses);

// Add pages to TabBarSplitterControl
tabBarSplitter.Controls.Add(incomePage);
tabBarSplitter.Controls.Add(expensesPage);

模式 3：VB.NET 实现

' Create TabBarPages
Private IncomePage As New Syncfusion.Windows.Forms.TabBarPage()
Private ExpensesPage As New Syncfusion.Windows.Forms.TabBarPage()

' Configure pages
IncomePage.Text = "Income"
IncomePage.Controls.Add(Me.gridControl1)

ExpensesPage.Text = "Expenses"
ExpensesPage.Controls.Add(Me.gridControl2)

' Add to TabBarSplitterControl
tabBarSplitterControl1.Controls.Add(Me.IncomePage)
tabBarSplitterControl1.Controls.Add(Me.ExpensesPage)

主要属性和类

TabBarSplitterControl

用途： 用于承载 TabBarPage 的主容器控件

主要成员：

• Controls - TabBarPage 对象集合
• 标准 WinForms 控件属性（Location、Size、Dock 等）

TabBarPage

用途： TabBarSplitterControl 中的独立页面

主要属性：

• Text - 页面选项卡标签
• Controls - 页面内控件的集合（通常为 GridControl）
• 标准 WinForms 控件属性

常见用例

1. 财务数据工作簿

为收入、支出和汇总创建单独的工作表，每个工作表都使用 GridControls 或 SfDataGrids。有关特定 NuGet 要求，请参阅子控件技能文件。

2. 多工作表报告

将不同的报告视图整理到单独的选项卡中，并在工作表之间交叉引用。根据客户需求使用适当的子控件。

3. 数据分析界面

显示多个数据网格，并使用公式引用不同页面中的数据。查看 GridControl 或 SfDataGrid 技能文件，了解实现详情。

4. 类电子表格应用

构建类似 Excel 的界面，其中每个选项卡都包含单独的数据网格或任何 Syncfusion/框架控件。

5. 多视图仪表板

创建选项卡式界面，其中每个页面都显示不同的数据可视化内容、网格视图或自定义控件。有关子控件实现，请参阅相应的技能文件。

设计器集成说明

也可以通过 Visual Studio 设计器添加 TabBarSplitterControl：

• 从工具箱拖放
• 使用 TabBarPageCollectionEditor 管理页面
• 可在设计器模式下使用编辑选项

注意： Claude 无法执行手动设计器操作。以编程方式实现时，请使用此技能中提供的模式和示例。

相关文档

有关 TabBarSplitterControl 的其他属性和方法，请参阅 Syncfusion 文档中的 Splitter 概述。

后续步骤

• 有关 TabBarSplitterControl 的安装和设置：阅读 references/getting-started.md
• 有关 TabBarSplitterControl 的代码实现：阅读 references/programmatic-implementation.md
• 有关子控件集成（GridControl、SfDataGrid 或任何控件）：
  • 在技能文件夹中参阅子控件的 references/getting-started.md 文件，了解 NuGet 包安装
  • 查看子控件的参考文件，了解正确的配置方法
  • 将子控件添加到 TabBarPages 之前，确保其已正确配置