タブ項目領域ツールバー (xamRibbon)

トピックの概要

目的

このトピックでは、タブ項目の隣にツールバーエリアを作成して構成する方法を説明します。

前提条件

このトピックをより理解するために、以下のトピックを参照することをお勧めします。

トピック	目的
xamRibbon について	このトピックでは、 xamRibbon コントロールの機能をより深く理解するうえで役立つ情報を提供します。
リボンタブ	このセクションの各トピックでは、 xamRibbon のリボンタブ領域について説明し、これを xamRibbon に追加する方法を示します。

このトピックの内容

このトピックは、以下のセクションで構成されます。

はじめに
タブ項目領域ツールバーの作成と構成
関連コンテンツ

はじめに

タブ項目領域ツールバーの概要

xamRibbon コントロールによって、タブの隣にツールバーを作成できます。このツールバーは、ItemsControl クラスから拡張され、あらゆる種類の内容をここに追加できます。

このツールバーは、タブ項目を右に配置した行に配置されます。ツールバーの内容をすべて表示するスペースが足りない場合は、一部が非表示になり、オーバーフローボタンが右に表示されます。このボタンをクリックすると、非表示のツールバーの内容をすべて表示したポップアップが開きます。

注:

Note	ツールバーの項目が非表示になり始める幅を決定する場合は、左側のタブ項目を表示するための幅の最小値を `TabItemAreaMinWidth` プロパティで指定します。

以下のスクリーンショットは、タブ項目領域ツールバーのある xamRibbon コントロールを示します。

以下のスクリーンショットは、オーバーフローポップアップが表示されている xamRibbon コントロールを示します。スペースが限られていてツールバーの全内容をタブ項目の隣に表示できないため非表示となっていた項目が、ポップアップに表示されます。

オーバーフローボタン
ポップアップに表示されたタブ項目領域ツールバー

タブ項目領域ツールバーの作成と構成

概要

タブ項目領域ツールバーは、 TabItemAreaToolbar クラスによって表示されます。ユーザーは、このインスタンスを作成し、xamRibbon の TabItemAreaToolbar プロパティに設定する必要があります。TabItemAreaToolbar クラスは、ツールバーの構成に使用するいくつかのプロパティを提供します。これらのプロパティを以下の表に説明します。

プロパティ設定

以下の表は、任意の構成 / 動作とそれを管理するプロパティ設定のマップを示します。

目的:	以下を実行します。
タブ項目領域ツールバーを作成します。	`TabItemAreaToolbar` クラスのインスタンスを作成します。
タブ項目領域ツールバーのインスタンスを xamRibbon コントロールに関連付けます。	インスタンスを xamRibbon の `TabItemAreaToolbar` プロパティに設定します。
タブ項目領域の幅の最小値を指定 (確保) します。	ツールバーの TabItemAreaMinWidth プロパティに任意の最小幅を設定します。
オーバーフローボタンの表示状態を取得します。	OverflowButtonVisibility プロパティの値を取得します。
タブ項目領域ツールバーのオーバーフロー領域を開くまたは閉じます。	IsOverflowOpen ブール値プロパティを設定または取得します。

例

以下のコード例は、タブ項目領域ツールバーを作成および設定する方法を示します。

XAML の場合:

<igRibbon:XamRibbon>
    <igRibbon:XamRibbon.TabItemAreaToolbar>
        <igRibbon:TabItemAreaToolbar TabItemAreaMinWidth="150">
        <!-- ここにタブ項目領域ツールバーの内容を追加 -->
        </igRibbon:TabItemAreaToolbar>
    </igRibbon:XamRibbon.TabItemAreaToolbar>
</igRibbon:XamRibbon>

WPF | ヘルプ トピック