Vcl.Menus.TMenuItem.ImageIndex

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property ImageIndex: TImageIndex read FImageIndex write SetImageIndex stored IsImageIndexStored default -1;

C++

__property System::Uitypes::TImageIndex ImageIndex = {read=FImageIndex, write=SetImageIndex, stored=IsImageIndexStored, default=-1};

Eigenschaften

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

Beschreibung

Gibt an, welches vom übergeordneten Menü bereitgestellte Bild neben dem Menüeintrag angezeigt wird.

Mit ImageIndex legen Sie ein Bild fest, das neben dem Text eingeblendet werden soll, wenn der Menüeintrag gezeichnet wird. Bei Hauptmenüeinträgen legt ImageIndex einen Index mit einem Null-Offset für die Eigenschaft Images des übergeordneten Menüs (TMenu oder TPopupMenu) an. Bei Untermenüeinträgen ist ImageIndex der Null-Offset-Index der Eigenschaft SubMenuImages des übergeordneten Menüeintrags.

Wenn das übergeordnete Menü oder der übergeordnete Eintrag keine Bilderliste enthält, stellen Sie über die Eigenschaft Bitmap ein Bild für einen einzelnen Menüeintrag bereit. Bilder, die über die Eigenschaft ImageIndex angegeben werden, erhalten den Vorrang vor mit der Eigenschaft Bitmap festgelegten Bildern. Bitmap wird nur verwendet, wenn ImageIndex einen negativen Wert hat oder die Eigenschaft Images oder SubMenuImages des übergeordneten Elements nil (Delphi) bzw. NULL (C++) ist.

Anmerkung:  Diese Eigenschaft wird nicht mit dem Menüeintrag gespeichert, wenn sie von einem TAction-Objekt bereitgestellt wird.

Siehe auch