功能区设计器

项目
10/10/2023

功能区设计器是一个视觉设计画布。使用功能区设计器将自定义选项卡、组和控件添加到Microsoft 办公室应用程序的功能区。

适用于： 本主题中的信息适用于以下应用程序的文档级项目和 VSTO 外接程序项目： Excel;InfoPath 2013 和 InfoPath 2010;前景;幻灯片;项目;Visio;词。有关详细信息，请参阅办公室应用程序和项目类型提供的功能。

若要打开功能区设计器，请将功能区（可视化设计器）项添加到项目。然后，可以将设计工具用于以下任务：

设计功能区布局
处理事件并设置控件属性
将控件添加到 Backstage 视图

注意

使用功能区设计器无法完成某些任务。有关这些任务以及如何完成这些任务的详细信息，请参阅功能区概述。

向项目添加功能区（可视化设计器）项

若要使用功能区设计器，请将新的 功能区（可视化设计器） 项添加到项目中。有关详细信息，请参阅 “如何：开始自定义功能区”。

添加新 的功能区（Visual Designer） 项时，Visual Studio 会自动将以下文件添加到项目中：

功能区代码文件。此文件具有您在“添加新项”对话框中为功能区（可视化设计器）项指定的名称。添加代码以处理此文件的功能区事件。
功能区设计器代码文件。此文件包含功能区设计器生成的代码，不应直接编辑。
资源文件。此文件包含功能区上每个控件的属性值。

如果已有来自另一 个项目的功能区（可视化设计器） 项，则可以使用“ 添加现有项 ”对话框在当前项目中重复使用它。

设计功能区

可通过三种方法打开功能区设计器：

在解决方案资源管理器中，双击功能区代码文件。
在解决方案资源管理器中，右键单击功能区代码文件，然后单击“视图设计器”。
在解决方案资源管理器中，选择功能区代码文件，然后单击“视图”菜单上的“设计器”。

功能区设计器包含默认选项卡和组。可以从功能区设计器中删除默认选项卡和组。若要删除默认组，请 右键单击 Group1，然后单击“ 删除”。若要删除默认选项卡，请右键单击设计图面的空白区域，然后单击“ 删除功能区”选项卡。

还可以将自定义选项卡、组和控件添加到功能区设计器。可以在工具箱中的办公室功能区控件组中找到这些控件。可通过三种方法将办公室功能区控件组中的控件添加到功能区设计器：
将控件拖到功能区设计器上的相应区域。
单击控件，然后单击功能区设计器中的相应区域。
在设计器中选择适当的区域，然后双击工具箱中的控件。

功能区设计工作流

按照以下基本步骤设计功能区布局：

将自定义选项卡添加到功能区。
向选项卡添加组。
将控件添加到组。

只能对组删除控件;不能将控件直接拖动到选项卡或功能区。只能在选项卡上删除组;不能将组直接拖动到功能区。

通过将控件拖动到正确的位置来排列控件。可以使用“属性”窗口设置控件的属性。

无法在功能区上将控件从一个选项卡拖动到另一个选项卡。如果要将控件移动到另一个选项卡，必须使用 “剪切 ”命令从一个选项卡中删除该控件，然后将该控件粘贴到另一个选项卡上。如果确实剪切控件并将其粘贴，事件处理程序将停止工作。可以在“属性”窗口中重新连接事件处理程序。有关详细信息，请参阅属性窗口。

向功能区添加自定义选项卡

可通过三种方法将自定义选项卡添加到功能区：

从 工具箱中添加选项卡。
右键单击功能区设计器，然后单击“ 添加功能区”选项卡。
打开 Tab 集合编辑器，然后单击“添加”。

若要打开 Tab 集合编辑器，请在“属性”窗口中选择 Tabs 属性，然后单击省略号按钮。

添加选项卡后，可以添加组以包含控件。

从功能区中删除自定义选项卡

可通过三种方法从功能区中删除自定义选项卡：

右键单击设计器，然后单击“ 删除功能区”选项卡。
在“属性”窗口的“命令”窗格中，单击“删除功能区”选项卡。
打开 Tab 集合编辑器，选择该选项卡，然后单击“删除”。

更改功能区上选项卡的位置

可以更改功能区上自定义选项卡的顺序。还可以在功能区上的内置选项卡之前或之后放置自定义选项卡。有关详细信息，请参阅 “如何：更改功能区上选项卡的位置”。

自定义功能区上的内置选项卡

内置选项卡是已在Microsoft 办公室应用程序功能区上的选项卡。例如， “数据 ”选项卡是 Excel 中的内置选项卡。

可以将组和控件添加到内置选项卡。默认情况下，自定义组显示为内置选项卡上的最后一个组，不过你可以在选项卡上的任何内置组之前或之后移动该组。

不能删除内置组。

有关如何自定义内置选项卡的详细信息，请参阅 “如何：自定义内置”选项卡。

向选项卡添加组

组在逻辑上组织功能区上的控件。向选项卡添加组。将所有其他控件添加到组。

向组添加控件

向组添加一个或多个控件。下表描述了每个控件。

控制	说明
Box	一个容器，用于组织组中的控件。可以将任何控件添加到除分隔符、组或选项卡以外的框。框可以是水平或垂直的。
按钮	启动操作的按钮。可以将按钮添加到组、按钮组、下拉列表、库、菜单或拆分按钮。
ButtonGroup	包含一个或多个按钮、切换按钮、菜单、拆分按钮和库的组。可以将按钮组添加到组或菜单。
CheckBox	已选中或清除以打开或关闭选项的框。
ComboBox	附加了列表框的编辑框。用户可以键入或选择自己的选择。该框显示当前所选内容。使用Items属性在功能区加载到办公室应用程序中之前或之后的运行时添加和删除项。
DropDown	用户可以选择的项列表。用户无法在下拉列表中键入新项。使用 Items 属性将项添加到列表中。可以在运行时添加和删除项。使用属性 Buttons 向列表添加按钮。但是，在功能区加载到办公室应用程序后，无法在运行时添加和删除按钮。
EditBox	用户可以在其中键入文本的框。
库	显示用户可以从中选择的视觉选择的数组或网格的菜单。可以在菜单中控制所选内容的布局。 ColumnCount使用属性RowCount和属性指定将显示库的项和按钮的行和列数。
标签	可用于标识功能区上的控件的文本。
菜单	可以包含以下任何控件的下拉列表： -按钮 - 复选框 -库 -菜单 - 拆分按钮 - 切换按钮 -分离若要向功能区设计器中的菜单添加控件，请单击菜单中的向下箭头以公开菜单设计图面。然后，可以将功能区控件从工具箱拖到菜单上。若要排列控件，请将控件拖动到所需位置。若要将控件添加到RibbonMenu功能区加载到办公室应用程序中后，必须在加载功能区之前将Dynamic属性设置为 true。有关如何执行此操作的信息，请参阅功能区对象模型概述。
分隔符	用于分隔列表中的项的细条。添加到组时，条形图垂直。添加到菜单时，条形图为水平。
SplitButton	附加了菜单的按钮。拆分按钮可以包含以下任一控件： -按钮 - 复选框 -库 -菜单 - 拆分按钮 - 切换按钮 -分离与菜单一样，拆分按钮具有自己的设计图面。但是，与菜单不同，只能在功能区加载到办公室应用程序中之前更新拆分按钮中的项。有关如何更新拆分按钮中的项的信息，请参阅功能区对象模型概述。
ToggleButton	显示已按下或未按下的按钮。

处理事件和设置属性

通过功能区设计器，可以使用“属性”窗口在设计时设置控件属性。此外，功能区还公开了一个强类型对象模型，可用于在运行时获取和设置功能区控件的属性。

可以双击设计器上的任何控件以打开控件的默认事件的事件处理程序。可以使用“属性”窗口为所有其他控件事件创建事件处理程序。

功能区事件和属性位于命名空间中 Microsoft.Office.Tools.Ribbon 。 功能区（可视化设计器）项会自动在项目中添加对此程序集的引用，并在功能区代码文件的顶部插入相应的 using 或 Imports 语句。

有关在运行时处理功能区事件和设置功能区控件的属性的信息，请参阅功能区对象模型概述。

自定义 Backstage 视图

可以使用功能区设计器将控件添加到单击“ 文件 ”选项卡时打开的菜单。此菜单称为 Backstage 视图。

无法使用功能区设计器在内置控件之前或之后放置控件。内置控件是已在 Backstage 视图中显示的控件。如果要在内置控件之前或之后放置控件，则必须使用功能区 XML。有关功能区（XML）的详细信息，请参阅功能区 XML。 有关自定义 Backstage 视图的详细信息，请参阅面向开发人员的办公室 2010 Backstage 视图简介，并为开发人员自定义办公室 2010 Backstage 视图。

有关如何将控件添加到 Backstage 视图的信息，请参阅 “如何：向 Backstage 视图添加控件”。