RibbonLabel 接口

定义

命名空间:

Microsoft.Office.Tools.Ribbon

程序集:

Microsoft.Office.Tools.Common.dll

表示 RibbonGroup 或 RibbonBox 上的标签。

public interface class RibbonLabel : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("7182361b-5a62-424e-9ab4-6d9a78432fb7")]
public interface RibbonLabel : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("7182361b-5a62-424e-9ab4-6d9a78432fb7")>]
type RibbonLabel = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonLabel
Implements IComponent, IDisposable, RibbonControl

属性

GuidAttribute

实现

RibbonComponent RibbonControl IComponent IDisposable

注解

将“标签”从“工具箱”的“Office 功能区控件”选项卡拖动到功能区Designer时，Visual Studio 会为你创建一个RibbonLabel对象。

若要在运行时向组添加标签，请创建一个新 RibbonLabel 对象，然后将此对象添加到 Items 的 集合 RibbonGroup 或 Items 的 RibbonBox集合中。 只能在加载功能区之前执行此操作。 有关详细信息，请参阅 功能区对象模型概述。

可以使用 对象的 方法RibbonFactory在运行时CreateRibbonLabel创建 RibbonLabel 。

可通过两种方法来访问 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。

属性

Enabled	获取或设置一个值，该值指示是否启用此 RibbonControl。 (继承自 RibbonControl)
Id	获取一个字符串，Microsoft Office 将用其标识此 RibbonControl 对象。 (继承自 RibbonControl)
Label	获取或设置通过标签显示的文本。
Name	获取或设置此 RibbonComponent 的名称。 (继承自 RibbonComponent)
Parent	获取一个 RibbonComponent，表示此 RibbonComponent 的父级。 (继承自 RibbonComponent)
Ribbon	获取包含控件层次结构的顶级 Ribbon 对象。 (继承自 RibbonComponent)
RibbonUI	获取 Microsoft Office 应用程序提供给功能区扩展性代码的 IRibbonUI 实例。 (继承自 RibbonComponent)
ScreenTip	此属性无效果。
ShowLabel	获取或设置一个值，该值指示标签显示的文本是否可见。
SuperTip	此属性无效果。
Tag	获取或设置与此 RibbonComponent 关联的应用程序特定的数据。 (继承自 RibbonComponent)
Visible	获取或设置一个值，该值指示此 RibbonControl 是否可见。 (继承自 RibbonControl)

方法

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)