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

项目
08/12/2011

更新：2010 年 9 月

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

提示

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

**适用于：**本主题中的信息适用于以下应用程序的文档级项目和应用程序级项目：Excel 2007 和 Excel 2010；InfoPath 2010；Outlook 2007 和 Outlook 2010；PowerPoint 2007 和 PowerPoint 2010；Project 2010；Visio 2010；Word 2007 和 Word 2010。有关更多信息，请参见按 Office 应用程序和项目类型提供的功能。

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

在**“解决方案资源管理器”中右击功能区代码文件，然后单击“视图设计器”**。
右击功能区设计器，然后单击**“将功能区导出到 XML”**。

Visual Studio 会向项目中添加一个功能区 XML 文件和一个功能区 XML 代码文件。
在功能区代码类中，找到以 TODO:. 开头的注释。
根据正在开发的解决方案的类型，将这些注释中的代码块复制到**“ThisAddin”、“ThisWorkbook”或“ThisDocument”**类中。

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

在**“ThisAddin”、“ThisWorkbook”或“ThisDocument”**类中，取消代码块的注释。

在取消注释代码后，您的代码应如下面的示例所示。本例中，功能区类的名称为 MyRibbon。

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。

请参见

修订记录

日期	修订记录	原因
2010 年 9 月	更改了文本中提到的功能区类的名称以匹配代码示例。	内容 Bug 修复

2010 年 9 月

更改了文本中提到的功能区类的名称以匹配代码示例。

内容 Bug 修复

通过

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

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

请参见

任务

概念

其他资源

修订记录

其他资源