RibbonSplitButton インターフェイス

[アーティクル]
08/09/2011

ボタンまたはトグルボタンとドロップダウンメニューを組み合わせたリボンコントロールです。

名前空間: Microsoft.Office.Tools.Ribbon
アセンブリ: Microsoft.Office.Tools.Common (Microsoft.Office.Tools.Common.dll 内)

構文

'宣言
<GuidAttribute("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")> _
Public Interface RibbonSplitButton _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")]
public interface RibbonSplitButton : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

RibbonSplitButton 型で公開されるメンバーは以下のとおりです。

プロパティ

	名前	説明
	ButtonEnabled	RibbonSplitButton でボタンが有効になっているかどうかを示す値を取得または設定します。
	ButtonType	RibbonSplitButton 上のボタンの種類を取得または設定します。
	Checked	RibbonSplitButton が押されているかどうかを示す値を取得または設定します。
	ControlSize	RibbonSplitButton コントロールのサイズを取得または設定します。
	Description	ドロップダウンメニューのこの RibbonSplitButton コントロールに表示されるテキストを取得または設定します。
	Enabled	この RibbonControl が使用可能になっているかどうかを示す値を取得または設定します。 (RibbonControl から継承されます。)
	Id	この RibbonControl オブジェクトを識別するために Microsoft Office で使用される文字列を取得します。 (RibbonControl から継承されます。)
	Image	コントロールに表示されるイメージを取得または設定します。
	ImageName	コントロールのイメージを指定するために E:Microsoft.Office.Tools.Ribbon.LoadImage イベントハンドラーで使用できる名前を取得または設定します。
	Items	この RibbonSplitButton 上のコントロールのコレクションを取得します。
	ItemSize	RibbonSplitButton ドロップダウンメニュー上のコントロールのサイズを取得または設定します。
	KeyTip	RibbonSplitButton コントロールのキーボードショートカットを取得または設定します。
	Label	RibbonSplitButton コントロールのテキストを取得または設定します。
	Name	この RibbonComponent の名前を取得または設定します。 (RibbonComponent から継承されます。)
	OfficeImageId	Microsoft Office の組み込みアイコンを使用する場合に、RibbonSplitButton コントロールに表示するイメージを取得または設定します。
	Parent	この RibbonComponent の親を表す RibbonComponent を取得します。 (RibbonComponent から継承されます。)
	Position	コントロールが Microsoft Office メニュー上にある場合に、RibbonSplitButton コントロールの位置を取得または設定します。
	Ribbon	コントロール階層を含む最上位の Ribbon オブジェクトを取得します。 (RibbonComponent から継承されます。)
	RibbonUI	インフラストラクチャ。 Microsoft Office アプリケーションによってリボン機能拡張コードに提供される IRibbonUI のインスタンスを取得します。 (RibbonComponent から継承されます。)
	ScreenTip	ユーザーがポインターを RibbonSplitButton コントロールの上に移動したときに表示されるツールヒントテキストを取得または設定します。
	ShowLabel	RibbonSplitButton コントロールのラベルが表示されるかどうかを示す値を取得または設定します。
	Site	IComponent に関連付けられた ISite を取得または設定します。 (IComponent から継承されます。)
	SuperTip	ユーザーがポインターを RibbonSplitButton コントロールの上に移動したときに表示される複数行のツールヒントテキストを取得または設定します。
	Tag	この RibbonComponent と関連付けられたアプリケーション固有のデータを取得または設定します。 (RibbonComponent から継承されます。)
	Title	RibbonSplitButton コントロールが Microsoft Office メニュー上にある場合に、このコントロールの上に表示されるタイトルを取得または設定します。
	Visible	この RibbonControl が表示されるかどうかを示す値を取得または設定します。 (RibbonControl から継承されます。)

このページのトップへ

メソッド

	名前	説明
	Dispose	アンマネージリソースの解放およびリセットに関連付けられているアプリケーション定義のタスクを実行します。 (IDisposable から継承されます。)
	PerformDynamicLayout	RibbonComponent に動的メニューなどの動的な親があり、レイアウトが中断されていない場合、親コントロールの Microsoft.Office.Core.IRibbonUI.InvalidateControl メソッドを呼び出します。 (RibbonComponent から継承されます。)
	PerformLayout	RibbonComponent に親があり、レイアウトが中断されていない場合、Microsoft.Office.Core.IRibbonUI.InvalidateControl を呼び出します。 (RibbonComponent から継承されます。)
	ResumeLayout()	SuspendLayout メソッドの実行結果を元に戻します。 (RibbonComponent から継承されます。)
	ResumeLayout(Boolean)	SuspendLayout メソッドの実行結果を元に戻します。 (RibbonComponent から継承されます。)
	SuspendLayout	Microsoft Office アプリケーションがリボン上のコントロールの状態を更新しないようにします。 (RibbonComponent から継承されます。)

このページのトップへ

イベント

	名前	説明
	Click	ユーザーが RibbonSplitButton コントロールをクリックすると発生します。
	Disposed	コンポーネントの Disposed イベントを処理するメソッドを表します。 (IComponent から継承されます。)

このページのトップへ

解説

RibbonSplitButton コントロールは、ボタンまたはトグルボタンとドロップダウンメニューを組み合わせます。ボタンまたはトグルボタンを選択するには、ButtonType プロパティを使用します。

RibbonMenu コントロールとは異なり、RibbonSplitButton コントロールには Dynamic プロパティがないため、実行時に Items コレクションの内容を変更することはできません。

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

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

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

注意

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

使用方法

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