[V17新特性]将Spread Ribbon 工具栏控件集成到Spread应用程序中

Spread.NET V17中新增了一个独立Ribbon 工具栏控件，可以用于Spread工作簿的编辑。

新增的Ribbon 工具栏控件提供了类似于Excel样式和行为的Ribbon UI。功能上包括了上下文行为，命令执行，错误处理以及完整的自定义选项，使开发人员可以轻松的直接在应用程序中提供最终用户熟悉的Excel外观样式。

在这篇教程中，将介绍如何将Spread Ribbon 工具栏控件集成到 WinForms 应用程序中

使用C＃添加电子表格功能栏控件到Winforms应用程序的步骤

• 创建 WinForms .NET 8 应用程序
• 在表单上添加 .NET 电子表格组件
• 使用 C# 将功能区栏控件附加到 .NET 电子表格实例
• 自定义Ribbon：通过代码自定义 .NET 电子表格功能区栏控件
  
  

下载示例Demo
RibbonBarControl.zip (297.79 KB, 下载次数: 341)

2024-3-13 12:21 上传

点击文件名下载附件

1.创建 一个.NET 8 WinForms 应用程序

在Visual Studio 2022中，创建一个新项目并选择其下包含C#的Windows窗体应用。

接下来，下载最新的 Spread.NET 版本并将其安装在您的计算机上。有关入门的更多信息，请参阅我们的快速入门文档。

或者，可以通过 NuGet 获取Spread.NET，搜索“GrapeCity-Software.Spread.WinForms”，然后选择安装

2.在表单上添加 .NET 电子表格组件

从 VS 工具箱中，将FpSpread组件拖放到窗体上。根据需要调整电子表格：

您已成功将 Spread.NET 组件添加到 WinForms 项目中。

3.将功能区栏控件附加到 .NET 电子表格实例

从 VS 工具箱中，将 RibbonBar工具栏组件拖放到电子表格实例顶部的窗体上。在Form1.cs文件中，添加以下代码以生成默认的 RibbonBar 项目和行为，并将RibbonBar工具栏控件附加到 Spreadsheet 组件：

1. using GrapeCity.Spreadsheet.WinForms.Ribbon;
   
2. 
   
3. namespace RibbonBarControl
   
4. {
   
5.     public partial class Form1 : Form
   
6.     {
   
7.         public Form1()
   
8.         {
   
9.             InitializeComponent();
   
10.             ribbonBar1.GenerateDefaultItems();
    
11.             // Attach ribbonBar control to FpSpread control
    
12.             ribbonBar1.Attach(fpSpread1);
    
13.         }
    
14.     }
    
15. }

复制代码

运行 WinForms 应用程序，可以看到Ribbon Bar 控件和 .NET Spreadsheet 实例正在协同工作，允许最终用户轻松导入/导出和修改 Excel 电子表格。

4.通过代码自定义 .NET 电子表格Ribbon工具栏控件

Spread.NET的Ribbon Bar控件支持通过API进行定制。控件本身由执行指定命令或操作的不同选项卡项组成。RibbonBar 的选项卡中提供了各种类型的组项目，例如工具栏、菜单、选项卡项目、图标等。开发人员可以添加、删除或修改功能区栏项以满足用户的需求。

以下示例代码包括

1.添加新选项卡（Tab）

2.在选项卡中添加新组（Group）

3.在组中添加新的项目（Item），你可以添加各种类型的Item,例如最常见的RibbonButton

4.通过CommandExecuting 事件定义了按钮对应的Command在执行的时候的逻辑代码

1. using GrapeCity.Spreadsheet;
   
2. using GrapeCity.Spreadsheet.WinForms.Ribbon;
   
3. 
   
4. namespace RibbonBarControl
   
5. {
   
6.     public partial class Form1 : Form
   
7.     {
   
8.         public Form1()
   
9.         {
   
10.             InitializeComponent();
    
11.             ribbonBar1.GenerateDefaultItems();
    
12.             // Attach ribbonBar control to FpSpread control
    
13.             ribbonBar1.Attach(fpSpread1);
    
14.             // Add custom items on ribbonBar
    
15.             ribbonBar1.Attach(fpSpread1);
    
16.             ribbonBar1.Tabs.Add(new GrapeCity.Spreadsheet.WinForms.Ribbon.RibbonTab());
    
17.             ribbonBar1.Tabs[8].Text = "New Tab";
    
18.             ribbonBar1.Tabs[8].Groups.Add(new RibbonGroup());
    
19.             ribbonBar1.Tabs[8].Groups[0].Text = "New Group";
    
20.             ribbonBar1.Tabs[8].Groups[0].Items.Add("New Item");
    
21.             ribbonBar1.Tabs[8].Groups[0].Items[0].Name = "test";
    
22.             ribbonBar1.Tabs[8].Groups[0].Items["test"].CommandName = "Orientation";
    
23.             ribbonBar1.Tabs[8].Groups[0].Items["test"].CommandParameter = 30;
    
24.             ribbonBar1.Tabs[0].Groups[0].Items[0].Visible = false;
    
25.             ((RibbonButton)ribbonBar1.Tabs[1].Groups[0].Items[0]).Text = "New Name";
    
26. 
    
27.             ribbonBar1.CommandExecuting += RibbonBar1_CommandExecuting; ;
    
28. 
    
29.         }
    
30. 
    
31.         private void RibbonBar1_CommandExecuting(object? sender, ExecuteCommandEventArgs e)
    
32.         {
    
33.             if (e.CommandName == "Orientation")
    
34.             {
    
35.                 //e.Handled = true;  //如果是要取消内置Command的默认操作，可以设置e.Handled = true
    
36. 
    
37.                 MessageBox.Show("Orientation Command is executing ");   
    
38.             }
    
39.         }
    
40.     }
    
41. }

复制代码