功能区控件示例
更新：2007 年 11 月
.gif "说明") 说明： |
|---|
此示例只能在 Microsoft Office Excel 2007 中运行。 |
此示例演示如何创建出现在 Microsoft Office Excel 工作表的功能区上的自定义选项卡。此自定义功能区演示 Visual Studio“工具箱”的“Office 功能区控件”组中提供的大多数控件。有关使用这些控件的更多信息，请参见功能区设计器。
.gif "安全说明") 安全说明： |
|---|
此示例代码的用途在于阐释概念，因此只显示了与该概念相关的代码。示例代码不一定满足特定环境的安全要求，不应原样照搬使用。我们建议您添加安全性代码和错误处理代码，让您的项目更加安全可靠。Microsoft 按“原样”提供此示例代码，不提供任何保证。 |
有关如何在计算机上安装示例项目的信息，请参见 如何：安装和使用“帮助”中找到的示例文件。
运行此示例
按 F5。
出现一个 Excel 工作表。该工作表的功能区显示一个名为“Ribbon Control Sample”（功能区控件示例）的自定义选项卡。
因为自定义功能区的 StartFromScratch 属性设置为 true，所以功能区不显示任何其他选项卡。
要求
此示例需要以下应用程序：
Visual Studio Tools for Office。
Microsoft Office Excel 2007。
演示
本示例演示以下概念：
使用“功能区(可视化设计器)”项模板自定义选项卡。
隐藏所有内置选项卡和 Office 菜单上的大多数命令，只显示在此功能区项中定义的自定义项。
将自定义组和控件添加到功能区设计器。
处理功能区上的控件的事件。
在运行时更改控件的属性。
在运行时动态地将控件添加到菜单中。
在运行时动态地将项添加到库中。
使用功能区上的按钮显示和隐藏操作窗格控件。
“Working with Sheets”（使用工作表）组
下表描述自定义功能区的“Working with Sheets”（使用工作表）组中出现的控件。
控件 |
说明 |
操作/结果 |
|---|---|---|
显示操作窗格 |
一个显示按下或未按下状态的切换按钮。 |
单击“显示操作窗格”。 一个操作窗格将出现在工作表的旁边。 再次单击“显示操作窗格”可隐藏操作窗格。 |
面孔按钮 |
包含在一个按钮组中的三个按钮。将这些按钮添加到该按钮组中的原因是它们彼此相关。按钮组中的按钮具有发亮的外观。 |
单击一个面孔按钮。 单元格 A1 显示匹配的图像。 |
对齐方式 |
一个拆分按钮。拆分按钮是一个具有附加菜单的按钮。“对齐方式”拆分按钮菜单包含三个按钮。“对齐方式”拆分按钮的 OfficeImageId 属性设置为内置 Office 对齐方式控件的 ID。 |
单击“对齐方式”拆分按钮菜单中的“右对齐”、“左对齐”或“居中对齐”。 单元格 A3 中出现的文本将右对齐、左对齐或居中。 |
颜色 |
一个库，提供可以从中进行选择的彩色球体的数组。 |
单击“颜色”，然后从库中选择一种颜色。 一个具有选定颜色的球体将出现在单元格 A6 中。 |
设置图表格式 |
一个包含图表格式列表的下拉控件。与组合框不同的是，您无法在下拉控件中键入选定内容。 |
单击“设置图表格式”，然后从列表中选择一种格式。 出现在工作表上的图表的格式将更改为与所选格式相匹配的格式。 |
MRU 查找 |
一个组合框。您可以键入或选择一个选项。 |
单击“MRU 查找”组合框，然后从列表中选择文本。 - 或 - 在“MRU 查找”组合框中键入任何文本，然后按 Enter。 将出现一个消息框，标识文本在工作表中的位置。 |
“Building Dynamic Menu”（生成动态菜单）组
下表描述自定义功能区的“Building Dynamic Menu”（生成动态菜单）组中出现的控件。
控件 |
说明 |
操作/结果 |
|---|---|---|
动态菜单 |
一个菜单。菜单是一个可以包含其他功能区控件的下拉列表。 此菜单的 Dynamic 属性设置为 true。这使此菜单能够在运行时动态更新。 |
单击“动态菜单”可显示控件的菜单。 |
“CheckBox”、“DropDown”、“SubMenu”、“Gallery”、“Button”、“Separator” |
一组复选框。可以选中或清除复选框以打开或关闭选项。 每个复选框都代表一个可以添加到“动态菜单”的功能区控件。 |
单击复选框可将功能区控件添加到“动态菜单”。 |