RibbonGallery クラス (2007 System)
更新 : 2007 年 11 月
RibbonDropDownItem オブジェクトおよび RibbonButton コントロールのメニューを表示するコントロールを表します。
名前空間 : Microsoft.Office.Tools.Ribbon
アセンブリ : Microsoft.Office.Tools.Common.v9.0 (Microsoft.Office.Tools.Common.v9.0.dll 内)
構文
'宣言
<ToolboxBitmapAttribute(GetType(RibbonGallery), "RibbonGallery.bmp")> _
Public NotInheritable Class RibbonGallery _
Inherits RibbonControl
'使用
Dim instance As RibbonGallery
[ToolboxBitmapAttribute(typeof(RibbonGallery), "RibbonGallery.bmp")]
public sealed class RibbonGallery : RibbonControl
解説
RibbonDropDown クラスと同様に、RibbonGallery は RibbonDropDownItem オブジェクトと RibbonButton コントロールのメニューを表示します。
RibbonDropDown クラスとは異なり、ユーザーが RibbonDropDownItem をクリックすると、RibbonGallery クラスは SelectionChanged イベントではなく Click イベントを発生させます。つまり、たとえば、ユーザーが同じ RibbonDropDownItem を 2 回クリックすると、Click イベントが 2 回発生します (SelectionChanged イベントは、RibbonDropDown での同じシナリオに対し、最初の選択が行われたときに、最初のクリックの前に何が選択されているかにより、多くても 1 回しか発生しません)。
ShowItemSelection プロパティは、現在選択されている RibbonDropDownItem と選択されていない項目で表示を変えるかどうかを制御します。RibbonGallery で選択できる項目は、一度に 1 つだけです。
ItemImageSize プロパティを使用すると、16 × 16 および 32 × 32 以外のイメージ サイズを指定できます。
RibbonDropDownItem オブジェクトは、デザイン時または実行時に RibbonGallery に追加できます。
デザイン時に RibbonDropDownItem オブジェクトを追加するには
[プロパティ] ウィンドウで [Items] プロパティをクリックします。
省略記号 (...) をクリックします。
DropDown コレクション エディタで、新しい項目の追加、順序の変更、および編集を行います。
次の手順では、実行時に RibbonDropDownItem を追加する方法を説明します。
実行時に RibbonDropDownItem オブジェクトを追加するには
RibbonDropDownItem を使用して、新しい RibbonDropDownItem を作成します。
作成した RibbonDropDownItem をこの RibbonGallery オブジェクトの Items コレクションに追加します。
デザイン時に、RibbonButton コントロールを RibbonGallery に追加できます。
デザイン時に RibbonButton コントロールを追加するには
[プロパティ] ウィンドウで [Buttons] プロパティをクリックします。
省略記号 (...) をクリックします。
Button コレクション エディタで、新しいボタン コントロールの追加、順序の変更、および編集を行います。
このコントロールの一部のプロパティは、実行時にリボンが Office アプリケーションに読み込まれる前、またはコントロールが動的メニューに追加される前にのみ設定できます。これらのプロパティの設定の詳細については、「リボン オブジェクト モデルの概要」を参照してください。
継承階層
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
Microsoft.Office.Tools.Ribbon.RibbonComponent
Microsoft.Office.Tools.Ribbon.RibbonControl
Microsoft.Office.Tools.Ribbon.RibbonGallery
スレッド セーフ
この型のすべてのパブリック static (Visual Basic では Shared) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
参照
参照
Microsoft.Office.Tools.Ribbon 名前空間