Vcl.Menus.NewSubMenu
Delphi
function NewSubMenu(const ACaption: string; hCtx: THelpContext;
const AName: string; const Items: array of TMenuItem; AEnabled: Boolean): TMenuItem;
C++
extern DELPHI_PACKAGE TMenuItem* __fastcall NewSubMenu(const System::UnicodeString ACaption, System::Classes::THelpContext hCtx, const System::UnicodeString AName, TMenuItem* const *Items, const int Items_High, bool AEnabled = true);
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, der ein Untermenü repräsentiert.
Mit NewSubMenu erstellen Sie zur Laufzeit programmgesteuert einen Menüeintrag, der ein Untermenü repräsentiert.
ACaption enthält den Text, der im übergeordneten Menü für den Eintrag angezeigt wird.
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.
Items enthält ein Array von Menüeinträgen für das Untermenü. Diese werden angezeigt, wenn der Benutzer im übergeordneten Menü auf das Untermenüelement klickt.
Anmerkung: Der Parameter Items_Size bezeichnet den Index des letzten Menüelements in Items (eins kleiner als die Anzahl der Menüelemente).
Der Parameter AEnabled gibt an, ob der Menüeintrag im übergeordneten Menü aktiviert ist.
Sobald das Untermenü mit NewSubMenu erzeugt wurde, kann es 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 NewSubMenu 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.