Share via


将功能区设计器中的功能区导出到功能区 XML

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

注意

并非所有属性值都显示在功能区 XML 文件中。 有关详细信息,请参阅 功能区概述

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

将功能区设计器中的功能区导出到功能区 XML

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

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

    Visual Studio 向项目添加功能区 XML 文件和功能区 XML 代码文件。

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

  4. 根据要开发的解决方案类型,将这些注释中的代码块复制到 ThisAddinThisWorkbookThisDocument 类。

    此代码使Microsoft 办公室应用程序能够发现和加载自定义功能区。 有关更多信息,请参见 Ribbon XML

  5. ThisAddinThisWorkbookThisDocument 类中,取消注释代码块。

    取消注释代码后,它应类似于以下示例。 在此示例中,将调用 MyRibbonRibbon 类。

    protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject()
    {
        return new MyRibbon();
    }
    
  6. 切换到功能区 XML 代码文件并查找 Ribbon Callbacks 区域。

    这是编写回调方法来处理用户操作的位置,例如单击按钮。

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

  8. 将所有事件处理程序代码从事件处理程序移动到回调方法,并修改代码以使用功能区扩展性 (RibbonX) 编程模型。

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