Vcl.Menus.NewLine

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function NewLine: TMenuItem;

C++

extern DELPHI_PACKAGE TMenuItem* __fastcall NewLine(void);

Eigenschaften

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

Beschreibung

Erzeugt einen Menüeintrag für eine Trennlinie.

Mit NewLine kann innerhalb eines Menüs eine Trennlinie platziert werden, um die einzelnen Elemente logisch zu gruppieren. Sobald der Menüeintrag für die Trennlinie erzeugt ist, kann er 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 NewLine 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