Vcl.Menus.TMenuItem.GroupIndex

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property GroupIndex: Byte read FGroupIndex write SetGroupIndex default 0;

C++

__property System::Byte GroupIndex = {read=FGroupIndex, write=SetGroupIndex, default=0};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
property published
Vcl.Menus.pas
Vcl.Menus.hpp
Vcl.Menus TMenuItem

Beschreibung

Legt die logische Gruppe fest, zu der ein Menüeintrag gehört.

Mit GroupIndex können Sie steuern, wie Menüs miteinander kombiniert werden. In Anwendungen, die aus mehreren Formularen bestehen, können die Menüeinträge eines Sekundärformulars in das Hauptmenü der Anwendung integriert werden, sobald das Sekundärformular aktiviert wird. MDI-Anwendungen kombinieren die Menüs untergeordneter Fenster immer mit dem Hauptmenü des übergeordneten Fensters.

Per Voreinstellung haben alle Einträge einer Menüleiste (Hauptmenü) denselben Wert für GroupIndex. Wenn Sie GroupIndex zum Kombinieren von Menüs verwenden wollen, setzen Sie den GroupIndex-Wert jedes nachfolgenden Menüeintrags auf einen Wert, der kleiner oder gleich dem des vorherigen Menüeintrags ist.

Wenn ein Eintrag einer Menüleiste, die in das Hauptmenü der Anwendung integriert wird, denselben GroupIndex-Wert wie ein Menüeintrag im Hauptmenü hat, wird der entsprechende Hauptmenüeintrag durch den neuen Eintrag ersetzt. Weisen mehrere Einträge im Hauptmenü der Anwendung denselben GroupIndex-Wert auf, werden sie nur durch einzelne Einträge aus dem Menü des Sekundärformulars ersetzt, wenn diese ebenfalls identische GroupIndex-Werte besitzen. Der erste Eintrag im Hauptmenü mit einem bestimmten Wert wird dann durch den ersten entsprechenden Eintrag des Sekundärformulars ersetzt, der zweite Eintrag im Hauptformular durch den zweiten Eintrag des Sekundärformulars usw.

Wenn ein Eintrag einer Menüleiste, die in das Hauptmenü der Anwendung integriert wird, einen GroupIndex-Wert hat, der zwischen demjenigen zweier benachbarter Hauptmenüeinträge liegt, wird der Eintrag zwischen diesen Einträgen eingefügt. Ist der GroupIndex-Wert des Eintrags größer als die GroupIndex-Werte aller Hauptmenüeinträge, wird der Eintrag am Ende des Hauptmenüs angefügt. Ist der GroupIndex-Wert des Eintrags dagegen kleiner als die GroupIndex-Werte aller Hauptmenüeinträge, wird er zum ersten Eintrag der Hauptmenüleiste.

Bei der Aktivierung eines Objekts, das von einer OLE 2.0-Server-Anwendung erzeugt wurde, versucht der Server möglicherweise, seine eigenen Menüs mit denen der Container-Anwendung zu kombinieren. Mit Hilfe der Eigenschaft GroupIndex können bis zu drei Hauptmenüeinträge durch die Menüs des Servers ersetzt werden. (Die Ersetzung der Menüeinträge erfolgt auf die beschriebene Art und Weise.) Die Server-Anwendung verwendet die folgenden vordefinierten GroupIndex-Werte, um die zu ersetzenden Menüeinträge zu ermitteln:



Gruppe Index Beschreibung

Edit

1

Einer oder mehrere Menüeinträge des Servers zur Bearbeitung des aktiven OLE-Objekts.

View

3

Einer oder mehrere Menüeinträge des Servers zur Änderung der Ansicht des OLE-Objekts.

Help

5

Einer oder mehrere Menüeinträge des Servers zum Zugriff auf die Hilfefunktionen des Servers.



Anmerkung:  Lesen Sie in der Dokumentation des verwendeten OLE-Servers nach, ob dieser versucht, Menüs während der Inplace-Aktivierung zu kombinieren.

Mit der Eigenschaft GroupIndex können auch Gruppen von Menüeinträgen definiert werden, die sich wie Optionsfelder verhalten. Dazu setzen Sie die Eigenschaft RadioItem aller Menüeinträge der betreffenden Gruppe auf true und weisen jedem Menüeintrag denselben Wert für GroupIndex zu. Wenn zur Laufzeit einer der Einträge im Menü markiert wird, führt dies zur Deaktivierung aller anderen Menüeinträge.

Siehe auch