RibbonGroup 接口

项目
05/20/2013

表示功能区选项卡上的一组控件。

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

语法

声明
<GuidAttribute("5d8ffee9-0105-497d-af15-6dcc5cc78310")> _
Public Interface RibbonGroup _
    Inherits RibbonComponent, IComponent, IDisposable

[GuidAttribute("5d8ffee9-0105-497d-af15-6dcc5cc78310")]
public interface RibbonGroup : RibbonComponent, 
    IComponent, IDisposable

RibbonGroup 类型公开以下成员。

属性

	名称	说明
	DialogLauncher	获取或设置与该组关联的功能区对话框启动器。
	Id	获取一个标识当前组的字符串。
	Items	获取组中的控件。
	KeyTip	获取或设置组的键盘快捷键。
	Label	获取或设置组的标签所显示的文本。
	Name	获取或设置此 RibbonComponent 的名称。（继承自 RibbonComponent。）
	Parent	获取一个表示此 RibbonComponent 的父级的 RibbonComponent。（继承自 RibbonComponent。）
	Position	获取或设置某个组在内置选项卡中的相对于该选项卡上的内置组的位置。
	Ribbon	获取包含控件层次结构的顶级 Ribbon 对象。（继承自 RibbonComponent。）
	RibbonUI	基础结构。获取 Microsoft Office 应用程序提供给功能区扩展性代码的 IRibbonUI 实例。（继承自 RibbonComponent。）
	Site	获取或设置与 IComponent 关联的 ISite。（继承自 IComponent。）
	Tag	获取或设置与此 RibbonComponent 关联的特定于应用程序的数据。（继承自 RibbonComponent。）
	Visible	获取或设置一个指示组是否可见的值。

页首

方法

	名称	说明
	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。）

页首

事件

	名称	说明
	DialogLauncherClick	在用户单击组中的功能区对话框启动器图标时发生。
	Disposed	表示处理组件的 Disposed 事件的方法。（继承自 IComponent。）

页首

备注

在将**“组”控件从“工具箱”的“Office 功能区控件”**选项卡拖入功能区设计器时，Visual Studio 将创建 RibbonGroup 对象。

常规任务

下表列出了对常规任务有用的成员。所有这些任务都可以在设计时执行。其中的某些任务可以在加载功能区之前在运行时执行。有关更多信息，请参见功能区对象模型概述。

任务	成员
访问组中的控件，向组中添加控件，或从组中移除控件。	使用 Items 属性。
将一个组添加到功能区选项卡。	将 RibbonGroup 添加到选项卡的 Groups 集合。
指定一个组在内置选项卡上的相对于内置组的位置。	使用 Position 属性。

在运行时，可以使用 RibbonFactory 对象的 CreateRibbonGroup 方法创建 RibbonGroup。

有两种方法可访问 RibbonFactory 对象：

使用功能区类的 Factory 属性。请通过功能区类中的代码使用此方法。
使用 Globals.Factory.GetRibbonFactory 方法。请通过功能区类之外的代码使用此方法。

说明
此接口由 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。