Vcl.Menus.NewItem

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function NewItem(const ACaption: string; AShortCut: TShortCut; AChecked, AEnabled: Boolean; AOnClick: TNotifyEvent; hCtx: THelpContext; const AName: string): TMenuItem;

C++

extern DELPHI_PACKAGE TMenuItem* __fastcall NewItem(const System::UnicodeString ACaption, System::Classes::TShortCut AShortCut, bool AChecked, bool AEnabled, System::Classes::TNotifyEvent AOnClick, System::Classes::THelpContext hCtx, const System::UnicodeString AName);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
Vcl.Menus.pas
Vcl.Menus.hpp
Vcl.Menus Vcl.Menus

Beschreibung

Erzeugt und initialisiert einen Menüeintrag.

Mit NewItem erzeugen und initialisieren Sie einen Menüeintrag, wenn ein Menü programmgesteuert erstellt wird.

ACaption enthält den Text des Menüeintrags.

AShortCut steht für ein eventuell zugeordnetes Tastenkürzel.

AChecked bestimmt, ob der Menüeintrag mit einem Häkchen markiert wird.

AEnabled legt fest, ob der Menüeintrag aktiviert ist oder nicht.

AOnClick bestimmt die Ereignisbehandlungsroutine, die ausgeführt wird, sobald der Benutzer auf den Menüeintrag klickt.

hCtx gibt die Hilfekontext-ID für den Menüeintrag an.

AName enthält den Namen, der im Programmcode für den Zugriff auf den Menüeintrag verwendet werden kann.

Der von NewItem zurückgegebene Wert kann mit der Methode Add des übergeordneten Objekts einem Menü hinzugefügt werden. Wenn das Menü zur Laufzeit dynamisch erzeugt wird, kann der neue Menüeintrag in ein Array eingefügt werden, das als Parameter an die Funktionen NewMenu, NewPopupMenu oder NewSubMenu übergeben wird.

Warnung:  Der von NewItem zurückgegebene Eintrag hat keinen Eigentümer. Der Programmierer muss den dem Eintrag zugewiesenen Arbeitsspeicher wieder freigeben, wenn der Eintrag nicht mehr benötigt wird. Die Methoden Delete und Remove von TMenuItem geben diesen Arbeitsspeicher nicht frei.

Siehe auch

Codebeispiele