VCL-Referenz
GroupIndex (Eigenschaft von TSpeedButton)
TSpeedButton Siehe auch
Die Eigenschaft GroupIndex ermöglicht das Gruppieren mehrerer Mauspalettenschalter.
Delphi-Syntax:
property GroupIndex: Integer;
C++ Syntax:
__property int GroupIndex = {read=FGroupIndex, write=SetGroupIndex, default=0};
Beschreibung
Mit GroupIndex können Sie festlegen, wie sich der Schalter beim Anklicken verhält.
Hat GroupIndex den Wert 0, ist der Schalter von den anderen Schaltflächen im Formular unabhängig. Klickt der Benutzer auf diesen Schalter, wird er gedrückt angezeigt. Sobald der Benutzer die Maustaste loslässt, wird er wieder in seinen nicht gedrückten Zustand versetzt.
Ist GroupIndex größer als 0, bleibt der Schalter ausgewählt (gedrückt), wenn der Benutzer auf ihn klickt. Durch das Klicken auf einen ausgewählten Schalter wird dieser in den nicht gedrückten Status versetzt, es sein denn, Caption hat den Wert False. Wird die Eigenschaft GroupIndex eines einzelnen Mauspalettenschalters auf einen Wert größer als 0 gesetzt, verhält sich der Schalter wie eine Schaltfläche mit zwei Zuständen, sofern Caption True ist.
Mauspalettenschalter, die denselben Wert in der Eigenschaft GroupIndex aufweisen (dieser Wert darf nicht Null sein), fungieren als Gruppe. Wenn der Benutzer auf einen dieser Mauspalettenschalter klickt, bleibt dieser gedrückt, bis der Benutzer auf einen anderen Schalter der Gruppe klickt. Auf diese Weise verwendete Mauspalettenschalter bieten dem Benutzer Auswahlmöglichkeiten an, die sich gegenseitig ausschließen.