如何:将功能区从功能区设计器导出为功能区 XML

更新:2007 年 11 月

适用对象

本主题中的信息仅适用于指定的 Visual Studio Tools for Office 项目和 Microsoft Office 版本。

项目类型

  • 文档级项目

  • 应用程序级项目

Microsoft Office 版本

  • Excel 2007

  • Word 2007

  • Outlook 2007

  • PowerPoint 2007

有关更多信息,请参见按应用程序和项目类型提供的功能

“功能区(可视化设计器)”项不支持功能区自定义项所有可能的类型。若要以高级方式自定义功能区,可从设计器中将功能区导出为功能区 XML,然后直接编辑 XML。

Bb386297.alert_note(zh-cn,VS.90).gif说明:

并非所有属性值都出现在功能区 XML 文件中。有关更多信息,请参见功能区概述

将功能区从功能区设计器导出为功能区 XML

  1. 在“解决方案资源管理器”中右击功能区代码文件,然后单击“视图设计器”。

  2. 右击功能区设计器,然后单击“将功能区导出到 XML”。

    Visual Studio Tools for Office 将一个功能区 XML 文件和一个功能区 XML 代码文件添加到项目中。

  3. 在功能区代码类中,找到以 TODO:. 开头的注释。

  4. 根据正在开发的解决方案的类型,将这些注释中的代码块复制到“ThisAddin”、“ThisWorkbook”或“ThisDocument”类中。

    通过这些代码,Microsoft Office 应用程序能发现并加载自定义功能区。有关更多信息,请参见功能区 XML

  5. 在“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();
    }
    
  6. 切换到功能区 XML 代码文件,然后找到 Ribbon Callbacks 区域。

    这里就是编写回调方法以处理用户操作(如单击按钮)的位置。

  7. 为在功能区设计器代码中编写的每一个事件处理程序创建一个对应的回调方法。

  8. 将所有事件处理程序代码从事件处理程序中移至回调方法,然后修改这些代码以使用可扩展功能区 (RibbonX) 编程模型。

    有关编写回调方法和使用 RibbonX 编程模型的信息,请参见功能区 XML

请参见

任务

演练:使用功能区设计器创建自定义选项卡

演练:使用功能区 XML 创建自定义选项卡

概念

功能区概述

功能区设计器

功能区 XML