RibbonGallery インターフェイス

定義

名前空間:

Microsoft.Office.Tools.Ribbon

アセンブリ:

Microsoft.Office.Tools.Common.dll

RibbonDropDownItem オブジェクトおよび RibbonButton コントロールのメニューを表示するコントロールを表します。

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

注意

これは、Visual Studio Tools for Office Runtime によって実装されたインターフェイスです。 コードに実装されるものではありません。 詳細については、「Visual Studio Tools for Office ランタイムの概要」を参照してください。

使用

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

プロパティ

Buttons	この RibbonGallery のボタン コレクションを取得します。
ColumnCount	この RibbonGallery 内の Item 列の数を取得または設定します。
ControlSize	RibbonGallery コントロールのサイズを取得または設定します。
Description	メニューまたは分割ボタンのこの RibbonGallery コントロールに表示されるテキストを取得または設定します。
Enabled	この RibbonControl が有効であるかどうかを示す値を取得または設定します。 (継承元 RibbonControl)
Id	この RibbonControl オブジェクトを識別するために Microsoft Office が使用する文字列を取得します。 (継承元 RibbonControl)
Image	ボタンに表示されるイメージを取得または設定します。
ImageName	LoadImage イベント ハンドラーで RibbonGallery を識別するために使用できる名前を取得または設定します。
ItemImageSize	この RibbonGallery 内の項目ごとに表示されるイメージのサイズを指定する Size を取得または設定します。
Items	この RibbonGallery の RibbonDropDownItem コンポーネントのコレクションを取得します。
KeyTip	この RibbonGallery のキーボード ショートカットを取得または設定します。
Label	この RibbonGallery に表示されるテキストを取得または設定します。
Name	この RibbonComponent の名前を取得または設定します。 (継承元 RibbonComponent)
OfficeImageId	Microsoft Office の組み込みアイコンを使用する場合に、ボタン上に表示するイメージを取得または設定します。
Parent	この RibbonComponent の親を表す RibbonComponent を取得します。 (継承元 RibbonComponent)
Position	ギャラリーが Microsoft Office メニュー上にある場合に、ギャラリーの位置を取得または設定します。
Ribbon	コントロール階層を含む最上位 Ribbon オブジェクトを取得します。 (継承元 RibbonComponent)
RibbonUI	Microsoft Office アプリケーションによってリボン機能拡張コードに提供される IRibbonUI のインスタンスを取得します。 (継承元 RibbonComponent)
RowCount	この RibbonDropDownItem が表示する RibbonGallery コンポーネントの行数を取得または設定します。
ScreenTip	ユーザーがポインターをこの RibbonGallery の上に移動したときに表示されるヒント テキストを取得または設定します。
SelectedItem	現在選択されている項目を取得または設定します。
SelectedItemIndex	現在選択されている RibbonDropDownItem のインデックスを取得または設定します。
ShowImage	RibbonGallery に関連付けられているイメージが表示されるかどうかを示す値を取得または設定します。
ShowItemImage	ギャラリー内の項目のイメージを表示するかどうかを指定する値を取得または設定します。
ShowItemLabel	この RibbonGallery の項目に対してラベルが表示されるかどうかを示す値を取得または設定します。
ShowItemSelection	現在選択されている RibbonDropDownItem を、選択されていない他の項目とは異なる表示にして区別するかどうかを示す値を取得または設定します。
ShowLabel	この RibbonGallery のラベルが表示されるかどうかを示す値を取得または設定します。
SuperTip	ユーザーがポインターを RibbonGallery の上に移動したときに表示される複数行のヒント テキストを取得または設定します。
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)

イベント

ButtonClick	ユーザーがこの RibbonGallery のボタンをクリックすると発生します。
Click	ユーザーがこの RibbonGallery の項目をクリックすると発生します。
ItemsLoading	この RibbonGallery が開いたときに発生します。