RibbonReadOnlyCollection Interface


リボンのカスタマイズで IRibbonExtension オブジェクトへのアクセスを提供します。Provides access to the IRibbonExtension objects in a Ribbon customization.

public interface RibbonReadOnlyCollection : System.Collections.Generic.ICollection<Microsoft.Office.Tools.Ribbon.IRibbonExtension>, System.Collections.Generic.IEnumerable<Microsoft.Office.Tools.Ribbon.IRibbonExtension>, System.Collections.Generic.IList<Microsoft.Office.Tools.Ribbon.IRibbonExtension>


このオブジェクトによって表されるコレクションにはIRibbonExtension 、リボンのカスタマイズで任意の型のすべてのオブジェクトIRibbonExtensionを含めることも、特定のメッセージクラスまたは Microsoft Office アプリケーションのオブジェクトのみを含めることもできます。The collection represented by this object can contain either all IRibbonExtension objects of any type in a Ribbon customization, or only those IRibbonExtension objects for a particular message class or Microsoft Office application.

プロジェクトにリボンを追加すると、Visual Studio によってGlobalsアプリケーションにクラスが追加されます。When you add a Ribbon to a project, Visual Studio adds the Globals class to your application. クラスのプロパティはRibbonsRibbonCollectionBaseクラスから派生したインスタンスを返します。 GlobalsThe Ribbons property of the Globals class returns an instance that is derived from the RibbonCollectionBase class. Globals.Ribbonsコレクションを使用すると、Office カスタマイズに関連付けられているリボンにアクセスできます。You can use the Globals.Ribbons collection to access Ribbons that are associated with your Office customization.


これは、Visual Studio Tools for Office Runtime によって実装されたインターフェイスです。This interface is implemented by the Visual Studio Tools for Office runtime. コードに実装されるものではありません。It is not intended to be implemented in your code. 詳細については、「 Visual Studio Tools for Office Runtime Overview」を参照してください。For more information, see Visual Studio Tools for Office Runtime Overview.


ここでは、.NET Framework 4 以降を対象とする Office プロジェクトで使用される型のバージョンについて説明します。This documentation describes the version of this type that is used in Office projects that target the .NET Framework 4 or later. .NET Framework 3.5 を対象とするプロジェクトでは、この型のメンバーが異なること、およびこのコード例が動作しないことがあります。In projects that target the .NET Framework 3.5, this type might have different members and the code examples provided for this type might not work. .NET Framework 3.5 を対象とするプロジェクトの型の詳細については、Visual Studio 2008 ドキュメントの次の参照セクションを参照してください。http://go.microsoft.com/fwlink/?LinkId=160658For documentation about this type in projects that target the .NET Framework 3.5, see the following reference section in the Visual Studio 2008 documentation: http://go.microsoft.com/fwlink/?LinkId=160658.



指定した型の IRibbonExtension がこの RibbonReadOnlyCollection にある場合は、そのインスタンスが返されます。Returns an instance of an IRibbonExtension of the specified type, if it exists in this RibbonReadOnlyCollection.

GetRibbonContextCollection(Object, Type)

指定したメッセージ クラスまたはアプリケーションに関連付けられている IRibbonExtension オブジェクトのコレクションを返します。Returns a collection of IRibbonExtension objects that are associated with a specified message class or application.