Vcl.Menus.TMenuItem.GroupIndex
Delphi
property GroupIndex: Byte read FGroupIndex write SetGroupIndex default 0;
C++
__property System::Byte GroupIndex = {read=FGroupIndex, write=SetGroupIndex, default=0};
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| property | published | Vcl.Menus.pas Vcl.Menus.hpp |
Vcl.Menus | TMenuItem |
説明
メニュー項目が所属する論理グループを識別します。
GroupIndex プロパティは，メニューのマージ方法を制御できます。フォームが複数あるアプリケーションで，フォームがアクティブになったときに，2 番めのフォームのメニューの項目をアプリケーションのメインフォームにマージすることができます。MDI アプリケーションは常に子ウィンドウのメニューを親ウィンドウのメインメニューにマージします。
デフォルトでは，メニューバー（メインメニュー）のすべてのメニュー項目の GroupIndex プロパティ値は同じです。GroupIndex プロパティを使ってメニューをマージするには，連続しているメニュー項目の GroupIndex プロパティ値を 1 つ前のメニュー項目の値と同じかそれより大きい値に設定します。
アプリケーションのメインメニューにマージされるメニューバーのメニュー項目の GroupIndex プロパティ値がメインメニューのメニュー項目と同じである場合，アプリケーションのメインメニューのメニュー項目は対応するメニュー項目に置き換えられます。アプリケーションのメインメニューの複数のメニュー項目が同じ GroupIndex プロパティ値を持つ場合は，それらのメニュー項目は同じように重複する GroupIndex プロパティ値を持つほかのフォームのメニューの各メニュー項目によってのみ置き換えることができます。つまり，ある GroupIndex プロパティ値を持つメインメニューの 1 番めのフィールドは，同じ値を持つ 2 番めのフォームの 1 番めの項目と置き換えられ，メインフォームの 2 番めの項目は 2 番めのフォームの 2 番めのフォームと置き換えられる，などのようになります。
アプリケーションのメインメニューにマージされるメニューバーのメニュー項目の GroupIndex プロパティ値がアプリケーションのメインメニューの 2 つの隣接する項目の GroupIndex プロパティ値の間に入る場合は，そのメニュー項目は 2 つの隣接する項目の間に挿入されます。項目の GroupIndex プロパティ値がアプリケーションのメインメニューのほかのすべての GroupIndex プロパティ値より大きい場合は，その項目はメインメニューの最後の項目になります。GroupIndex プロパティ値がアプリケーションのメインメニューのほかのすべての GroupIndex プロパティ値より小さい場合は，その項目はメインメニューバーの最初の項目になります。
OLE 2.0 サーバーアプリケーションで作成したオブジェクトをアクティブにすると，OLE サーバーアプリケーションによってはサーバーがサーバーのメニューをコンテナアプリケーションのメニューとマージしようとします。GroupIndex プロパティを使用して，上記の方法で，最大 3 つまでのメインメニュー項目をサーバーからの項目に置き換えます。サーバーアプリケーションは，以下に示す定義済みの GroupIndex プロパティ値を使って置き換えるメニュー項目を見つけます。
| グループ | インデックス | 説明 |
|---|---|---|
|
編集 |
1 |
アクティブな OLE オブジェクトを編集するサーバーメニュー項目 |
|
表示 |
3 |
OLE オブジェクトの表示を変更するサーバーメニュー項目 |
|
ヘルプ |
5 |
サーバーのオンラインヘルプにアクセスするサーバーメニュー項目 |
メモ： インプレースアクティベーション時に OLE サーバーがメニューのマージを試みるかどうかについては OLE サーバーのマニュアルを参照してください。
また，GroupIndex プロパティは，ラジオボタンのように動作するメニュー項目のグループを定義するのにも使用することができます。メニュー項目をラジオボタンのように動作させるには，グループ内のすべてのメニュー項目の RadioItem プロパティを true に設定し，各メニュー項目に同じ GroupIndex プロパティ値を割り当てます。グループ内のいずれか 1 つのメニュー項目をチェックするとほかの項目はチェックがはずれます。