如何:将功能区从功能区设计器导出为功能区 XML
更新:2007 年 11 月
适用对象 |
---|
本主题中的信息仅适用于指定的 Visual Studio Tools for Office 项目和 Microsoft Office 版本。 项目类型
Microsoft Office 版本
有关更多信息,请参见按应用程序和项目类型提供的功能。 |
“功能区(可视化设计器)”项不支持功能区自定义项所有可能的类型。若要以高级方式自定义功能区,可从设计器中将功能区导出为功能区 XML,然后直接编辑 XML。
说明: |
---|
并非所有属性值都出现在功能区 XML 文件中。有关更多信息,请参见功能区概述。 |
将功能区从功能区设计器导出为功能区 XML
在“解决方案资源管理器”中右击功能区代码文件,然后单击“视图设计器”。
右击功能区设计器,然后单击“将功能区导出到 XML”。
Visual Studio Tools for Office 将一个功能区 XML 文件和一个功能区 XML 代码文件添加到项目中。
在功能区代码类中,找到以 TODO:. 开头的注释。
根据正在开发的解决方案的类型,将这些注释中的代码块复制到“ThisAddin”、“ThisWorkbook”或“ThisDocument”类中。
通过这些代码,Microsoft Office 应用程序能发现并加载自定义功能区。有关更多信息,请参见功能区 XML。
在“ThisAddin”、“ThisWorkbook”或“ThisDocument”类中,取消代码块的注释。
在取消注释代码后,您的代码应如下面的示例所示。本例中,功能区类的名称为 Ribbon1。
Protected Overrides Function CreateRibbonExtensibilityObject() As _ Microsoft.Office.Core.IRibbonExtensibility Return New MyRibbon() End Function
protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject() { return new MyRibbon(); }
切换到功能区 XML 代码文件,然后找到 Ribbon Callbacks 区域。
这里就是编写回调方法以处理用户操作(如单击按钮)的位置。
为在功能区设计器代码中编写的每一个事件处理程序创建一个对应的回调方法。
将所有事件处理程序代码从事件处理程序中移至回调方法,然后修改这些代码以使用可扩展功能区 (RibbonX) 编程模型。
有关编写回调方法和使用 RibbonX 编程模型的信息,请参见功能区 XML。