RibbonReadOnlyCollection 接口

项目
05/20/2013

提供对功能区自定义项中的 IRibbonExtension 对象的访问。

命名空间： 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("c3b587bc-42bc-401b-a1e7-f85777d5156a")> _
Public Interface RibbonReadOnlyCollection _
    Inherits IList(Of IRibbonExtension), ICollection(Of IRibbonExtension),  _
    IEnumerable(Of IRibbonExtension), IEnumerable

[GuidAttribute("c3b587bc-42bc-401b-a1e7-f85777d5156a")]
public interface RibbonReadOnlyCollection : IList<IRibbonExtension>, 
    ICollection<IRibbonExtension>, IEnumerable<IRibbonExtension>, IEnumerable

RibbonReadOnlyCollection 类型公开以下成员。

属性

	名称	说明
	Count	获取 ICollection<T> 中包含的元素数。（继承自 ICollection<IRibbonExtension>。）
	IsReadOnly	获取一个值，该值指示 ICollection<T> 是否为只读。（继承自 ICollection<IRibbonExtension>。）
	Item	获取或设置位于指定索引处的元素。（继承自 IList<IRibbonExtension>。）

页首

方法

	名称	说明
	Add	将某项添加到 ICollection<T> 中。（继承自 ICollection<IRibbonExtension>。）
	Clear	从 ICollection<T> 中移除所有项。（继承自 ICollection<IRibbonExtension>。）
	Contains	确定 ICollection<T> 是否包含特定值。（继承自 ICollection<IRibbonExtension>。）
	CopyTo	从特定的 Array 索引开始，将 ICollection<T> 的元素复制到一个 Array 中。（继承自 ICollection<IRibbonExtension>。）
	GetEnumerator	返回一个循环访问集合的枚举器。（继承自 IEnumerable<IRibbonExtension>。）
	GetRibbon	基础结构。如果在此 RibbonReadOnlyCollection 中存在指定类型的 IRibbonExtension 实例，则返回该实例。
	GetRibbonContextCollection	基础结构。返回与指定的邮件类或应用程序关联的 IRibbonExtension 对象的集合。
	IndexOf	确定 IList<T> 中特定项的索引。（继承自 IList<IRibbonExtension>。）
	Insert	将一个项插入指定索引处的 IList<T>。（继承自 IList<IRibbonExtension>。）
	Remove	从 ICollection<T> 中移除特定对象的第一个匹配项。（继承自 ICollection<IRibbonExtension>。）
	RemoveAt	移除指定索引处的 IList<T> 项。（继承自 IList<IRibbonExtension>。）

页首

备注

此对象表示的集合可包含功能区自定义项中任何类型的所有 IRibbonExtension 对象，也可只包含某个特定消息类或 Microsoft Office 应用程序的那些 IRibbonExtension 对象。

在将功能区添加到项目时，Visual Studio 会将 Globals 类添加到应用程序。 Globals 类的 Ribbons 属性返回一个从 RibbonCollectionBase 类派生的实例。使用 Globals.Ribbons 集合可以访问与 Office 自定义项关联的功能区。

备注

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