Vcl.Menus.TMenuItem.RadioItem

Übergeordnet: TMenuItem

Delphi

property RadioItem: Boolean read FRadioItem write SetRadioItem default False;

C++

__property bool RadioItem = {read=FRadioItem, write=SetRadioItem, default=0};

Eigenschaften

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

Beschreibung

Legt fest, ob die Aktivierung des Menüeintrags zur Deaktivierung aller anderen Einträge in der Gruppe führt.

Mit RadioItem können Sie festlegen, ob sich ein Menüeintrag innerhalb einer Gruppe von Einträgen wie ein Optionsfeld verhält. Die Gruppe der Menüeinträge wird dabei durch die Eigenschaft GroupIndex festgelegt. Alle Einträge in einem Popup- oder Dropdown-Menü, die denselben GroupIndex-Wert aufweisen, gehören zu einer Gruppe. Wenn RadioItem den Wert true hat, kann in der Gruppe, die den Menüeintrag enthält, immer nur ein Eintrag ausgewählt werden. Der ausgewählte Menüeintrag wird durch einen Punkt neben dem Text des Eintrags (Eigenschaft Caption) kenntlich gemacht.

Anmerkung: RadioItem markiert den Eintrag nicht automatisch, wenn der Benutzer ihn zur Laufzeit anklickt: Sie müssen als Reaktion auf das OnClick-Ereignis trotzdem die Eigenschaft Checked auf true setzen. RadioItem ändert nur dann automatisch die Darstellung des Status Checked (von einem Häckchen in einen Punkt) und entfernt die Markierung von anderen Menüeinträgen derselben Gruppe, wenn die Eigenschaft Checked auf true gesetzt ist.

RadioItem kann nicht für Einträge in der obersten Ebene eines Hauptmenüs verwendet werden.