Vcl.Buttons.TSpeedButton.GroupIndex

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property GroupIndex: Integer read FGroupIndex write SetGroupIndex default 0;

C++

__property GroupIndex = {default=0};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
property published
Vcl.Buttons.pas
Vcl.Buttons.hpp
Vcl.Buttons TSpeedButton

Beschreibung

Ermöglicht das Gruppieren mehrerer Symbolschaltflächen.

Mit GroupIndex können Sie festlegen, wie sich die Schaltfläche beim Anklicken verhält.

Hat GroupIndex den Wert 0, ist die Schaltfläche von den anderen Schaltflächen im Formular unabhängig. Klickt der Benutzer auf diese Schaltfläche, wird sie gedrückt angezeigt. Sobald der Benutzer die Maustaste loslässt, wird sie wieder in den nicht gedrückten Zustand versetzt.

Ist GroupIndex größer als 0, bleibt die Schaltfläche ausgewählt (gedrückt), wenn der Benutzer darauf klickt. Durch das Klicken auf eine ausgewählte Schaltfläche wird diese in den nicht gedrückten Status versetzt, es sein denn, AllowAllUp hat den Wert false. Wird die Eigenschaft GroupIndex einer einzelnen Symbolschaltfläche auf einen Wert größer als 0 gesetzt, verhält sich die Schaltfläche wie eine Schaltfläche mit zwei Zuständen, sofern AllowAllUp true ist.

Symbolschaltflächen mit demselben Wert in der Eigenschaft GroupIndex (dieser Wert darf nicht 0 sein) fungieren als Gruppe. Wenn der Benutzer auf eine dieser Schaltflächen klickt, bleibt diese gedrückt, bis der Benutzer auf eine andere Schaltfläche der Gruppe klickt. Auf diese Weise verwendete Schaltflächen bieten dem Benutzer Auswahlmöglichkeiten an, die sich gegenseitig ausschließen.

Siehe auch