OfficeRibbon 接口

表示 Visual Studio 中通过使用 Office 项目中的功能区设计器创建的 Microsoft Office 功能区自定义项。

命名空间：  Microsoft.Office.Tools.Ribbon
程序集：   Microsoft.Office.Tools.Common.v4.0.Utilities（在 Microsoft.Office.Tools.Common.v4.0.Utilities.dll 中）
  Microsoft.Office.Tools.Common（在 Microsoft.Office.Tools.Common.dll 中）

语法

声明
<GuidAttribute("49fbf223-6d24-4c4b-9101-2d5833434328")> _
Public Interface OfficeRibbon _
    Inherits RibbonComponent, IComponent, IDisposable

[GuidAttribute("49fbf223-6d24-4c4b-9101-2d5833434328")]
public interface OfficeRibbon : RibbonComponent, 
    IComponent, IDisposable

OfficeRibbon 类型公开以下成员。

属性

	名称	说明
	Context	获取 Outlook 中与此功能区关联的检查器窗口或资源管理器窗口。
	DefaultExtension	获取此 OfficeRibbon 对象的默认扩展。
	Extension	获取此 OfficeRibbon 对象的自定义扩展。
	Global	获取或设置一个值，该值确定此 OfficeRibbon 是否可以同时在多个上下文中使用。
	Name	获取或设置此 RibbonComponent 的名称。 （继承自 RibbonComponent。）
	OfficeMenu	获取一个表示 Microsoft Office 菜单自定义项的 RibbonOfficeMenu。
	Parent	获取一个表示此 RibbonComponent 的父级的 RibbonComponent。 （继承自 RibbonComponent。）
	Ribbon	获取包含控件层次结构的顶级 Ribbon 对象。 （继承自 RibbonComponent。）
	RibbonId	获取用于创建 OfficeRibbon 对象的此实例的功能区 ID。
	RibbonType	获取功能区 ID 的逗号分隔的列表，这些功能区 ID 与此 OfficeRibbon 实例相关联。
	RibbonUI	基础结构。获取 Microsoft Office 应用程序提供给功能区扩展性代码的 IRibbonUI 实例。 （继承自 RibbonComponent。）
	Site	获取或设置与 IComponent 关联的 ISite。 （继承自 IComponent。）
	StartFromScratch	获取或设置一个值，该值指示是否隐藏功能区上的所有内置选项卡和 Microsoft Office 菜单上的大部分命令，并仅显示在此功能区项中定义的自定义项。
	Tabs	获取 RibbonOfficeMenu 中 RibbonTab 对象的集合。
	Tag	获取或设置与此 RibbonComponent 关联的特定于应用程序的数据。 （继承自 RibbonComponent。）

页首

方法

	名称	说明
	_VtblGap1_2
	Dispose	执行与释放或重置非托管资源相关的应用程序定义的任务。 （继承自 IDisposable。）
	PerformDynamicLayout	如果 RibbonComponent 有一个动态父级（如动态菜单）且布局未挂起，则调用父控件的 Microsoft.Office.Core.IRibbonUI.InvalidateControl 方法。 （继承自 RibbonComponent。）
	PerformLayout	如果 RibbonComponent 有父级，并且布局未挂起，则调用 Microsoft.Office.Core.IRibbonUI.InvalidateControl。 （继承自 RibbonComponent。）
	ResumeLayout()	取消 SuspendLayout 方法的效果。 （继承自 RibbonComponent。）
	ResumeLayout(Boolean)	取消 SuspendLayout 方法的效果。 （继承自 RibbonComponent。）
	SuspendLayout	阻止 Microsoft Office 应用程序刷新功能区上的控件的状态。 （继承自 RibbonComponent。）

页首

事件

	名称	说明
	Close	关闭此 OfficeRibbon 实例时发生。
	Disposed	表示处理组件的 Disposed 事件的方法。 （继承自 IComponent。）
	Load	当 OfficeRibbon 加载到 Microsoft Office 应用程序时发生。
	LoadImage	如果为一个或多个控件设置 ImageName 属性，则在 OfficeRibbon 加载时发生。

页首

备注

通常不直接使用 OfficeRibbon 界面。 相反，使用向项目中添加新的“功能区(可视化设计器)”项时 Visual Studio 生成的 Ribbon 类。 通过使用功能区类中的事件和属性，可以完成与生成的功能区相关的大部分任务。

生成的功能区类继承自 RibbonBase 类。 该基类将对其成员的所有调用重定向到 Visual Studio Tools for Office Runtime 的 OfficeRibbon 接口的内部实现。 如果您要直接使用 OfficeRibbon 对象，请使用生成的 Ribbon 类的 Base 属性。

备注

此接口由 Visual Studio Tools for Office Runtime 实现。不应在代码中实现此接口。有关更多信息，请参见 Visual Studio Tools for Office Runtime 概述。

用法

本文档介绍面向 .NET Framework 4 和 .NET Framework 4.5 的 Office 项目中所用此类型的版本。在面向 .NET Framework 3.5 的项目中，此类型可能具有不同的成员，因此本文档为此类型提供的代码示例可能并不适用。有关面向 .NET Framework 3.5 的项目中的此类型的文档，请参见 Visual Studio 2008 文档中的以下参考部分：https://go.microsoft.com/fwlink/?LinkId=160658。

请参见

参考

Microsoft.Office.Tools.Ribbon 命名空间