コマンドをリボンに追加する

提供: RAD Studio
移動先: 案内、 検索

リボン コントロールを使用したアプリケーションの作成方法 への移動

このトピックでは、リボン アプリケーション ウィザードまたは「リボン コントロールを使用したアプリケーションを作成する」でリボン アプリケーションを作成する方法を順に説明します。

このトピックでは、TActionManager コンポーネントの内容と使用方法について理解していることを前提にしています。 新しい多くのプロパティがリボンの要件をサポートするときに役立つように追加されています。 リボンで表示されているコマンドに対して変更するときに、既存の多くのプロパティに影響はありません。

次に例を示します：

  • 小さいボタンでは常にキャプションの左にグリフが表示されます。
  • 大きいボタンでは常に上にグリフが表示されます。
  • 大きいボタンではキャプションが必要です。 キャプションは最大 2 行で、ボタンの幅がキャプションに応じて変わります。 大きいボタンの高さは、コマンドが表示されているグループの高さをカバーするように固定されています。
  • キャプションのない小さいボタンのみがグループに表示できます。

新しいプロパティ

CommandStyle：CommandStyle ではこのコマンドをリボンで表現するために使用するコントロールのタイプを決定します。 デフォルトのスタイルは csButton です。 CommandStyle は 1 つの例外を除いてコマンドで使用するためにコントロール タイプを決定するために幅広く使用されます。 

type TCommandStyle = (csButton, csMenu, csSeparator, csText, csGallery, csComboBox, csControl, csCustom);

リボン グループでのコマンドのスタイル

csButton

コマンドはボタン。

csComboBox

コマンドは Office 2007 スタイルのコンボ ボックスを表示します。 （下記のメモを参照）。

csControl

コマンドには関連付けられた TControl の下位クラスがあります。 例では TEdit コンポーネントをリボン グループにドロップします。

csCustom

ユーザー定義です。

csGallery

コマンドはギャラリー、つまり選択されたとき、ギャラリーを表示します。

csMenu

コマンドはメニュー項目です。

csSeparator

コマンドはテキスト説明の区切り記号です。

csText

コマンドはテキストを表示するだけで、関連するコントロールがありません。


メモ： TRibbonComboBox をツール パレットから最初にリボン グループに配置する場合は、csComboBox CommandStyle のみ使用できます。

CommandProperties： CommandProperties はダイナミック プロパティ クラスです。 このプロパティの公開プロパティ（TPersistent の下位クラス）は、選択されている CommandStyle の種類により変わります。 csButton CommandStyle を選択している場合は、使用 CommandProperties クラスは TButtonProperties と呼ばれます。 このプロパティ クラスは csButton CommandStyle に固有のプロパティを公開します。

たとえば、ButtonSize では、ボタンが大きいボタンか小さいボタンかどうかを示すことができます。 サイズを変更してもメニューが変わらないので、csMenu コマンドでは、ButtonSize プロパティは必要ありません。

すべての CommandProperties クラスは TCommandProperties から派生します。 csCustom CommandStyle を使用している場合は、TCommandProperties クラスから派生する必要があります。


選択した CommandStyle に依存する CommandProperties プロパティで利用可能なプロパティ

csButton

ButtonSize
ボタンのサイズ：

TButtonSize = (bsSmall, bsLarge);

ButtonType
許可されているボタンの特別タイプ：

TButtonType = (btNone, btDropDown, btSplit, btGallery);
// btNone - 通常のボタン  
// btDropdown - ドロップダウン メニューを表示するボタン 
// btSplit - ドロップダウン メニューとデフォルト アクションがあるボタン   
// btGallery - ドロップダウンとしてギャラリーを表示するボタン

GroupPosition
コマンド グループでの対象コマンドの位置：

TGroupPosition = (gpNone, gpStart, gpMiddle, gpEnd, gpSingle);
// ボタンのまわりに境界を描画するかどうかを決定   
// gpNone - 境界の描画なし   
// gpStart - 右端の境界の描画なし   
// gpMiddle - 上下の境界の描画   
// gpEnd - 左端の境界の描画なし 
// gpSingle - 完全な境界を描画

csCheckBox

コマンドは、Office 2007 のチェック ボックスのように表示されます。

csComboBox

AllowResize
コンボ ボックスに関連付けられたポップアップ メニューがサイズ変更できるかどうかを制御します。

TGalleryResize = (grNone, grVertical, grBoth);
// grNone – サイズ変更不可    
// grVertical – 縦方向のみサイズ変更可能 
// grBoth – 縦横方向にサイズ変更可能

Items
ユーザーがドロップダウン ボタンを選択したときに表示する項目。 これらの項目はウィンドウに通常のコンボ ボックスのように表示されます。
Text
コンボ ボックスに表示されるテキストです。
Width
スピナー コントロールの幅（キャプションの幅を除く）です。

csControl

ContainedControl
リボンで関連付けられているコントロールへの参照です。

csCustom

ユーザー定義です。

csGallery

csGallery CommandProperties クラスは、csButton CommandProperties クラスから派生しています。つまり、すべての csButton プロパティは、csGallery コマンドの他、次のギャラリー クラスに対しても利用可能です。

GalleryType
表示されるギャラリーのタイプです：

TGalleryType = (gtDropDown, gtGrid, gtRibbon);
// gtDropDown - Gallery はドロップダウン メニュー形式です。
// gtGrid - Gallery はグリッド レイアウトで、複数交差して項目を持つことができます。
// ItemsPerRow  - 横に並ぶ項目の数を制御します。
// gtRibbon - Gallery はリボン形式です。

ItemsPerRow
行に表示される項目数。
ShowRichContent
True に設定するとギャラリー項目にリッチ コンテンツを表示します。

メモ：csGalleryCommandStyle を gtRibbonTGalleryType と共に使用するのは、現在のバージョンではサポートされていませんが、他の 2 つの TGalleryType は使用可能です。

csMenu

ShowRichContent
True に設定するとメニュー項目にリッチ コンテンツを表示します。

Content
リッチ コンテンツとして表示されるコンテンツです。

Font
リッチ コンテンツを表示するときにカスタム フォントを使用します。 リッチ コンテンツ メニュー項目は 2 行に制限されています。 コンテンツにより、メニュー項目は拡張されますが、高さは変更されません。したがって一部のメニュー項目では行が追加されます（2 行を超えることも可能）。

csRadioButton

コマンドは、Office 2007 のラジオ ボタンのように表示されます。

csSeparator

csText と csSeparator は同じ CommandProps クラスを共有し、したがって利用可能なプロパティは同じです。
Alignment
キャプション テキストの配置です。
EllipsisPosition
省略記号の位置（メニューの幅に対してキャプション テキストが長すぎる場合）。 アプリケーション メニューに表示されるメニュー項目に対してのみ可能です。
Font
キャプション テキストを描画するときに使用するフォントです。
Width
作成したコントロールの幅を強制的に特定のサイズにします。 csSeparator CommandStyle は -1 のままにして、csText CommandStyle は必要に応じて変更します。

csText

csText と csSeparator は同じ CommandProps クラスを共有し、したがって利用可能なプロパティは同じです。


その他のリボン コンポーネントのプロパティ

KeyTip： キーボードを使用しているときにコマンドを有効にするために押すキーです。 KeyTips を有効にするには、Alt または F10 キーを押します。

NewCol： コマンドに対して NewCol を設定すると、リボン グループの新しい列に強制的にコントロールが表示されます。 リボン グループの配置が gaVertical であるときのみこのプロパティが有効です。

NewRow：コマンドに対して NewRow を設定すると、リボン グループの新しい行に強制的にコントロールが表示されます。 リボン グループの配置が gaHorizontal であるときのみこのプロパティが有効です。

Default：True に設定するとメニュー項目のキャプションを強制的に太字で表示します。メニュー項目に対してのみ有効です。

関連項目

「http://docwiki.embarcadero.com/RADStudio/Berlin/j/index.php?title=コマンドをリボンに追加する&oldid=177096」から取得