RibbonGallery インターフェイス

定義

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

[System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")]
public interface RibbonGallery : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")>]
type RibbonGallery = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonGallery
Implements IComponent, IDisposable, RibbonControl

属性

GuidAttribute

実装

RibbonComponent RibbonControl IComponent IDisposable

注釈

インターフェイスと同様にRibbonDropDown、オブジェクトとRibbonButtonコントロールのRibbonDropDownItemメニューRibbonGalleryが表示されます。

RibbonDropDownインターフェイスとは異なり、 インターフェイスはRibbonGallery、ユーザーが をクリックしたときにイベントではなくSelectionChangedイベントをRibbonDropDownItem発生させますClick。 これは、たとえば、ユーザーが同じRibbonDropDownItemを Click 2 回クリックしたときにイベントが 2 回発生することを意味します。 (イベントは、最初の SelectionChanged クリック前の選択内容に応じて、 で同じシナリオに RibbonDropDown対して最初の選択が行われたときに、最大で 1 回発生します)。

プロパティは ShowItemSelection 、現在選択 RibbonDropDownItem されている が選択されていない項目と視覚的に区別されるかどうかを制御します。 では、一度に 1 つの項目のみを選択 RibbonGalleryできます。

プロパティを ItemImageSize 使用して、16 x 16 および 32 x 32 以外のイメージ サイズを指定できます。

デザイン時に RibbonDropDownItem オブジェクトを追加するには

1. [プロパティ] ウィンドウで Items プロパティをクリックします。

2. 省略記号 (...) をクリックします。

3. DropDown コレクション エディターで、新しいアイテムを追加、並べ替え、編集します。

コントロールは、デザイン時に にRibbonGallery追加RibbonButtonできます。

デザイン時に RibbonButton コントロールを追加するには

1. [プロパティ] ウィンドウで [Buttons] プロパティをクリックします。

2. 省略記号 (...) をクリックします。

3. [ボタン コレクション] エディターで、新しいボタン コントロールを追加、並べ替え、編集します。

オブジェクトの メソッドを RibbonGallery 使用して、 を CreateRibbonGallery 実行時に RibbonFactory 作成できます。

RibbonFactory オブジェクトにアクセスするには、次の 2 つの方法があります。

• リボン クラスの Factory プロパティの使用。 この方法は、リボン クラス内のコードから使用します。

• Globals.Factory.GetRibbonFactory メソッドの使用。 この方法は、リボン クラス外のコードから使用します。

このコントロールの一部のプロパティは、リボンが Office アプリケーションに読み込まれる前、または実行時にコントロールが動的メニューに追加される前にのみ設定できます。 これらのプロパティの設定の詳細については、「 リボン オブジェクト モデルの概要」を参照してください。

使用

ここでは、.NET Framework 4 以降を対象とする Office プロジェクトで使用される型のバージョンについて説明します。 .NET Framework 3.5 を対象とするプロジェクトでは、この型のメンバーが異なること、およびこのコード例が動作しないことがあります。 .NET Framework 3.5 を対象とするプロジェクトの型の詳細については、Visual Studio 2008 ドキュメントの次の参照セクションを参照してください。http://go.microsoft.com/fwlink/?LinkId=160658