RibbonDropDown インターフェイス

定義

名前空間:

Microsoft.Office.Tools.Ribbon

アセンブリ:

Microsoft.Office.Tools.Common.dll

ユーザーが選択できる項目のリストと、ユーザーがクリックできる [リボン] ボタンのリストを表します。

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

[System.Runtime.InteropServices.Guid("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")]
public interface RibbonDropDown : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")>]
type RibbonDropDown = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonDropDown
Implements IComponent, IDisposable, RibbonControl

属性

GuidAttribute

実装

RibbonComponent RibbonControl IComponent IDisposable

注釈

にはRibbonDropDown、オブジェクトとRibbonButtonコントロールを含RibbonDropDownItemめることができます。

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

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

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

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

リボンが Office に Buttons 読み込まれた後、実行時にコレクションにボタンを追加することはできません。

以下の手順では、 にオブジェクトとRibbonButtonコントロールを追加RibbonDropDownItemするRibbonDropDown方法について説明します。

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

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

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

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

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

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

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

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

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

この種類の一部のメンバーは、リボンが 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	この RibbonDropDown に属する RibbonButton オブジェクトのコレクションを取得します。
Enabled	この RibbonControl が有効であるかどうかを示す値を取得または設定します。 (継承元 RibbonControl)
Id	この RibbonControl オブジェクトを識別するために Microsoft Office が使用する文字列を取得します。 (継承元 RibbonControl)
Image	この RibbonDropDown に表示されるイメージを取得または設定します。
ImageName	コントロールのイメージを指定するために LoadImage イベント ハンドラーで使用できる名前を取得または設定します。
Items	この RibbonDropDown に含まれる項目のコレクションを取得します。
KeyTip	この RibbonDropDown のキーボード ショートカットを取得または設定します。
Label	この RibbonDropDown に表示されるテキストを取得または設定します。
Name	この RibbonComponent の名前を取得または設定します。 (継承元 RibbonComponent)
OfficeImageId	Microsoft Office の組み込みアイコンを使用する場合に、RibbonDropDown 上に表示するイメージを取得または設定します。
Parent	この RibbonComponent の親を表す RibbonComponent を取得します。 (継承元 RibbonComponent)
Ribbon	コントロール階層を含む最上位 Ribbon オブジェクトを取得します。 (継承元 RibbonComponent)
RibbonUI	Microsoft Office アプリケーションによってリボン機能拡張コードに提供される IRibbonUI のインスタンスを取得します。 (継承元 RibbonComponent)
ScreenTip	ユーザーがポインターを RibbonDropDown の上に移動したときに表示されるヒント テキストを取得または設定します。
SelectedItem	現在選択されている RibbonDropDownItem を取得または設定します。
SelectedItemIndex	現在選択されている RibbonDropDownItem のインデックスを取得または設定します。
ShowImage	RibbonDropDown に関連付けられているイメージが表示されるかどうかを示す値を取得または設定します。
ShowItemImage	ドロップダウン メニュー内の項目のイメージを表示するかどうかを指定する値を取得または設定します。
ShowItemLabel	ドロップダウン メニュー内の項目のラベルを表示するかどうかを指定する値を取得または設定します。
ShowLabel	この RibbonDropDown のラベルが表示されるかどうかを示す値を取得または設定します。
SizeString	RibbonDropDown のサイズを決定する文字列を取得または設定します。
SuperTip	ユーザーがポインターを RibbonDropDown の上に移動したときに表示される複数行のヒント テキストを取得または設定します。
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	ユーザーが RibbonDropDown のボタンをクリックすると発生します。
ItemsLoading	コントロールが RibbonDropDown に読み込まれるときに発生します。
SelectionChanged	ユーザーが、リボンのドロップダウン コントロール上の新しい項目を選択したときに発生します。