通过

IRibbonExtensibility.GetCustomUI 方法 (Office)

  • 项目

从 XML 自定义文件或过程中嵌入的 XML 标记加载 XML 标记，以自定义功能区用户界面。

语法

表达式。GetCustomUI (RibbonID)

表达 返回 IRibbonExtensibility 对象的表达式。

参数

名称 必需/可选 数据类型 说明
RibbonID 必需 字符串 RibbonX UI 的 ID。

返回值

String

备注

对于 Word、Excel、PowerPoint 和 Access，每个应用程序只有一个 ID。 Outlook 不仅使用功能区扩展性来自定义检查器中的功能区，还可以在资源管理器、各种上下文菜单、功能区上的上下文选项卡和 Microsoft Office Backstage 视图中自定义功能区。 对于其中的每种情况，开发人员将在 XML 文件中指定自定义 UI，在 Office 使用特定功能区 ID 调用 GetCustomUI 时，将加载该文件。

示例

在以下用 C# 编写的示例中，IRibbonExtensibility 接口是在类定义中指定的。 该示例随后将实现该接口的唯一方法 GetCustomUI。 方法创建 StreamReader 对象的实例，该对象读取外部 XML 文件中的自定义标记。

public class Connect : Object, Extensibility.IDTExtensibility2, IRibbonExtensibility 
... 
public string GetCustomUI(string RibbonID) 
{ 
 StreamReader customUIReader = new System.IO.StreamReader("C:\\RibbonXSampleCS\\customUI.xml"); 
 string customUIData = customUIReader.ReadToEnd(); 
 return customUIData; 
}

另请参阅

支持和反馈

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