RibbonGroup 接口
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示功能区选项卡上的一组控件。
public interface class RibbonGroup : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonComponent, System::ComponentModel::IComponent[System.Runtime.InteropServices.Guid("5d8ffee9-0105-497d-af15-6dcc5cc78310")]
public interface RibbonGroup : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonComponent, System.ComponentModel.IComponent[<System.Runtime.InteropServices.Guid("5d8ffee9-0105-497d-af15-6dcc5cc78310")>]
type RibbonGroup = interface
interface RibbonComponent
interface IComponent
interface IDisposablePublic Interface RibbonGroup
Implements IComponent, IDisposable, RibbonComponent- 属性
- 实现
注解
将“组”控件从“工具箱”的“Office 功能区控件”选项卡拖动到功能区Designer时，Visual Studio 会创建RibbonGroup对象。
常见任务
下表列出了对常见任务有用的成员。 所有这些任务都可以在设计时执行。 其中一些任务可以在加载功能区之前在运行时执行。 有关详细信息，请参阅 功能区对象模型概述。
| 任务 | 成员 |
|---|---|
| 访问组中的控件，向组添加控件，或从组中删除控件。 | 使用 Items 属性。 |
| 将组添加到功能区选项卡。 | RibbonGroup将 添加到Groups选项卡的集合。 |
| 指定组在内置选项卡上相对于内置组的位置的位置。 | 使用 Position 属性。 |
可以在运行时使用 CreateRibbonGroup 对象的 方法RibbonFactory创建 RibbonGroup 。
可通过两种方法来访问 RibbonFactory 对象：
通过使用 Ribbon 类的
Factory属性。 可从 Ribbon 类中的代码使用此方法。通过使用
Globals.Factory.GetRibbonFactory方法。 可从 Ribbon 类外的代码使用此方法。
注意
此接口由 Visual Studio Tools for Office Runtime 实现。 不应在代码中实现此接口。 有关更多信息，请参见 Visual Studio Tools for Office Runtime Overview。
使用情况
本文档介绍面向 .NET Framework 4 或更高版本的 Office 项目中所用的此类型的版本。 在面向 .NET Framework 3.5 的项目中，此类型可能具有不同的成员，因此本文档为此类型提供的代码示例可能并不适用。 有关在面向 .NET Framework 3.5 的项目中使用此类型的文档，请参阅 Visual Studio 2008 文档中的以下参考部分：http://go.microsoft.com/fwlink/?LinkId=160658。
属性
| DialogLauncher |
获取或设置与组关联的功能区对话启动程序。 |
| Id |
获取一个标识当前组的字符串。 |
| Items |
获取组中的控件。 |
| KeyTip |
获取或设置组的键盘快捷键。 |
| Label |
获取或设置组标签所显示的文本。 |
| Name |
获取或设置此 RibbonComponent 的名称。 (继承自 RibbonComponent) |
| Parent |
获取一个 RibbonComponent，表示此 RibbonComponent 的父级。 (继承自 RibbonComponent) |
| Position |
获取或设置内置选项卡上的组的位置（相对于选项卡上的内置组）。 |
| Ribbon |
获取包含控件层次结构的顶级 Ribbon 对象。 (继承自 RibbonComponent) |
| RibbonUI |
获取 Microsoft Office 应用程序提供给功能区扩展性代码的 IRibbonUI 实例。 (继承自 RibbonComponent) |
| Tag |
获取或设置与此 RibbonComponent 关联的应用程序特定的数据。 (继承自 RibbonComponent) |
| Visible |
获取或设置一个值，该值指示组是否可见。 |
方法
| PerformDynamicLayout() |
如果 RibbonComponent 具有一个动态父级（如动态菜单）且布局未挂起，则调用父控件的 Microsoft.Office.Core.IRibbonUI.InvalidateControl 方法。 (继承自 RibbonComponent) |
| PerformLayout() |
如果 具有一个父级，且布局未挂起，则调用 RibbonComponentMicrosoft.Office.Core.IRibbonUI.InvalidateControl。 (继承自 RibbonComponent) |
| ResumeLayout() |
取消 SuspendLayout() 方法的效果。 (继承自 RibbonComponent) |
| ResumeLayout(Boolean) |
取消 SuspendLayout() 方法的效果。 (继承自 RibbonComponent) |
| SuspendLayout() |
阻止 Microsoft Office 应用程序刷新功能区上的控件状态。 (继承自 RibbonComponent) |
事件
| DialogLauncherClick |
在用户单击组中的功能区对话启动程序时发生。 |