使用 Open XML 格式文件自定义 Office Fluent 功能区

项目
04/07/2023

Microsoft Office Fluent 用户界面的功能区组件为用户提供了使用 Office 应用程序的灵活方法。功能区扩展性 (RibbonX) 使用简单的基于文本的声明性 XML 标记来创建和自定义功能区。

本主题中的代码示例演示如何将自定义组件添加到单个文档的功能区，而不是添加应用程序级自定义项。在下面的步骤中，将向 Word 中的现有功能区添加自定义选项卡、自定义组和自定义按钮。还会为用于向文档插入公司名称的按钮实现回调过程。

在任何文本编辑器中创建自定义项文件，然后使用名称 customUI.xml 保存该文件。

向文件添加以下 XML 标记，然后关闭并保存该文件。

 <customUI xmlns="http://schemas.microsoft.com/office/2006/01/customui"> 
   <ribbon> 
     <tabs> 
       <tab id="CustomTab" label="My Tab"> 
         <group id="SampleGroup" label="Sample Group"> 
           <button id="Button" label="Insert Company Name" size="large" onAction="ThisDocument.InsertCompanyName" /> 
         </group > 
       </tab> 
     </tabs> 
   </ribbon> 
 </customUI>

在桌面上创建名为 customUI 的文件夹并将 XML 自定义文件复制到该文件夹。
使用自定义架构验证 XML 标记。

注意

此为可选步骤。
在 Word 中创建一个文档，并使用名称 RibbonSample.docm 保存它。

打开 Visual Basic 编辑器，并将以下过程添加到 ThisDocument 代码模块。关闭并保存文档。

  Sub InsertCompanyName(ByVal control As IRibbonControl) 
  ' Inserts the specified text at the beginning of a range or selection. 
  Dim MyText As String 
  Dim MyRange As Object 
  Set MyRange = ActiveDocument.Range 
  MyText = "Microsoft Corporation" 
  ' Range Example: Inserts text at the beginning 
  ' of the active document 
  MyRange.InsertBefore (MyText) 
  ' Selection Example: 
  'Selection.InsertBefore (MyText) 
End Sub

向文档文件名中添加 .zip 扩展名，然后双击它以打开文件。
通过将 customUI 文件夹从桌面拖动到 .zip 文件，向容器添加自定义项文件。
将 .rels 文件提取到桌面。包含 .rels 文件的 _rels 文件夹将被复制到桌面。
打开 .rels 文件并在最后一个 Relationship 标记和 Relationships 标记之间添加以下行。这将在文档文件和自定义项文件之间创建关系。
```
 <Relationship Id="someID" Type="http://schemas.microsoft.com/office/2006/relationships/ui/extensibility" Target="customUI/customUI.xml" />
```
关闭并保存该文件。
从桌面拖动 .rels 文件夹，将其重新添加到容器文件中，并覆盖现有文件。
通过删除 .zip 扩展名将文档文件重命名为其原始名称。
打开文档并注意，功能区现在显示“我的选项卡”选项卡。
单击该选项卡，你会注意到带有一个按钮控件的“示例组”组。
选择该按钮可以将公司名称插入到文档中。

另请参阅

支持和反馈

有关于 Office VBA 或本文档的疑问或反馈？请参阅 Office VBA 支持和反馈，获取有关如何接收支持和提供反馈的指南。

通过

使用 Open XML 格式文件自定义 Office Fluent 功能区

另请参阅

支持和反馈

反馈

其他资源