リボン カスタマイズ ダイアログを使用

リボン カスタマイズ ダイアログによって、エンドユーザーはリボン タブ、グループおよびツールをカスタマイズできます。WinRibbonCustomizationProvider コントロールによって実装されます。いったん実装されたら、ユーザーは右クリックのコンテキスト メニューのオプションを使用してアクセスできます（詳細は「WinRibbonCustomizationProvider について」を参照してください）。

このダイアログにはデフォルトで、リボンをカスタマイズとクイック アクセス ツール バー（QAT）をカスタマイズの 2 つのタブが表示されます。これらの対応するカスタマイズ コントロールは、RibbonCustomizationControl （リボンをカスタマイズ タブ）と QATCustomizationControl（クイック アクセス ツール バーをカスタマイズ）です。左側のリボンをカスタマイズ タブには、すべての ultraToolbarsManager 項目（AvailableItemsView）がリストされます。右側には、リボンのコンテンツと構造（RibbonLayoutView）、つまりタブ、グループ、ツールが表示されます。

図 1: リボン カスタマイズ ダイアログとリボンをカスタマイズ タブ

既存/デフォルト/ストック タブ、グループ、ツールのカスタマイズを有効にするには、UltraRibbonCustomizationProvider コンポーネントの StockItemModificationOptions プロパティを使用します。このプロパティはフラグ列挙型です。ユーザーに許可したいストック項目変更の型を指定する必要があります。デフォルトでこのプロパティは None に設定されます。

Visual Basic の場合:

C# の場合:

リボンまたはクイック アクセス ツール バーのカスタマイズを無効にするには、UltraRibbonCustomizationProvider コンポーネントの AllowRibbonCustomization プロパティまたは AllowQATCustomization プロパティを使用します。これらのプロパティを False に設定すると、対応するコンテキスト メニュー オプション（リボンをカスタマイズまたはクイック アクセス ツール バーをカスタマイズ）をユーザーが使用するのを防止します。

Visual Basic の場合:

C# の場合:

ダイアログを変更する機能は、UltraRibbonCustomizationProvider コンポーネントの BeforeCustomizationDialogDisplayed イベントと AfterCustomizationDialogClosed イベントで提供されます。

UltraToolbarsManager コンポーネントも、BeforeRibbonCustomizationDialogDisplayed と AfterRibbonCustomizationDialogClosed という 2 つのイベントを公開します。

UltraToolbarsManager の Ribbon はランタイムにダイアログを表示するために ShowRibbonCustomizationDialog メソッドを公開します。このメソッドの RibbonCustomizationType 引数は、リボンをカスタマイズとクイック アクセス ツール バー（QAT）をカスタマイズのいずれのタブがダイアログでアクティブになるかを指定します。

Visual Basic の場合:

C# の場合:

コマンドの選択コンボ ボックスがすべてのコマンドに設定されると、カスタマイズ ダイアログに ultraToolbarsManager に追加されたすべてのツールが表示されます。ただし、PopularCommand プロパティを使用して、一般的なコマンド ツールとしてより広く使用されるツールをグループ化できます。このプロパティによって、コマンドの選択コンボ ボックスを一般的なコマンドに設定すると、ツールを表示できます。

Visual Basic の場合:

C# の場合:

既存/デフォルト/ストック タブ、グループ、ツールをカスタマイズするには、UltraRibbonCustomizationProvider の StockItemModificationOptions プロパティを使用します。このタイプのプロパティは、どのタイプの変更をストック項目に行うことができるのかを指定することができるフラグ列挙体です。使用可能な列挙値は以下のとおりです。

Visual Basic の場合:

C# の場合:

デフォルトで、リボンのデザイン時初期化が完了すると、リセット ボタン機能のこの保存ポイントが作成されます。ただし、CreateRestorePoint と呼ばれるメソッドも、保存ポイントを作成する機能を提供する ultraToolbarsManager で公開されます。これによって、リボンをプログラムによってデザイン/変更し、「デフォルト」のレイアウトにこれらの変更が含まれるようにすることができます。Restore メソッドは、UltraToolbarsManager をこの内部保存される復元ポイントに復元します。

Visual Basic の場合:

C# の場合:

図 2: マウス ポインターが Home タブのヘッダー上にホバーすると、RibbonLayoutView でユーザー操作を提供するボタンは表示される

以下は、リボン カスタマイズ ダイアログで使用可能なユーザー操作です。

削除（X）ボタンでリボンからタブが削除されます。RibbonLayoutView のタブ ヘッダー上にホバーするとこのボタンが表示されます（上記の図 2 を参照してください）。

表示/非表示ボタンでタブの表示/非表示を切り替えます。このボタンは、RibbonLayoutView のタブ ヘッダー上の目のアイコンで表されます。マウスがタブ ヘッダー上にある、またはヘッダーが選択されるとこのボタンが表示されます（上記の図 2 を参照してください）。

タブのキャプションと画像は、ペン アイコンで表される変更ボタンで変更されます。マウスがタブ ヘッダー上にある、またはヘッダーが選択されるとこのボタンが表示されます（上記の図 2 を参照してください）。変更ボタンをクリックすると、リボン タブを変更という別のダイアログが表示します。このダイアログはタブのキャプションと画像を変更する機能を提供します。

タブ ヘッダーの左側にあるドラッグ ハンドルでタブの位置を変更できます。

図 3: タブ内でグループをカスタマイズするために使用されるボタン

削除（X）ボタンでリボンからグループが削除されます。RibbonLayoutView のグループ ヘッダー上にホバーする、またはグループ ヘッダーが選択されるとこのボタンが表示されます。

グループの表示/非表示は、RibbonLayoutView のグループ ヘッダー上の目のアイコンによって表される表示/非表示ボタンで切り替えます。マウスがグループ ヘッダー上にある、またはヘッダーが選択されるとこのボタンが表示されます。

グループのキャプションと画像は、ペン アイコンで表される変更ボタンで変更されます。マウスがグループ ヘッダー上にホバーする、またはヘッダーが選択されるとこのボタンが表示されます（上記の図 3 を参照してください）。このボタンをクリックすると、リボン グループを変更という別のダイアログが表示します。このダイアログは、リボン グループのキャプション、画像、グループ内のツールのサイズを変更する機能を提供します。

グループ ヘッダーの左側にあるドラッグ ハンドルでグループの位置を変更できます。

図 4: グループ内でツールをカスタマイズするために使用されるボタン

既存のツールを追加するには、ユーザーは以下を実行します。

削除（X）ボタンでリボンからグループが削除されます。RibbonLayoutView のツール要素上にホバーするとこのボタンが表示されます。

グループの表示/非表示は、RibbonLayoutView のツール要素上の目のアイコンによって表される表示/非表示ボタンで切り替えます。マウスがツール要素上にある、またはヘッダーが選択されるとこのボタンが表示されます（上記の図 4 を参照してください）。

ツールのキャプションと画像は、ペン アイコンで表される変更ボタンで変更されます。このボタンをクリックすると、ツールを変更という別のダイアログが表示します。このダイアログは、ツールのキャプション、画像、サイズ指定の動作を変更する機能を提供します。マウスがツール要素上にある、またはツールが選択されるとこのボタンが表示されます。

ツール要素の左側にあるドラッグ ハンドルでツールの位置を変更できます。

ダイアログの一番下にあるインポートおよびエクスポート ボタンによって、リボンのレイアウトを保存するだけでなく、バイナリと XML 形式のいずれかで以前に保存したレイアウトをロードできます。