Vcl.Menus.NewItem
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);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | Vcl.Menus.pas Vcl.Menus.hpp |
Vcl.Menus | Vcl.Menus |
Description
Crée et initialise un élément de menu.
Appelez NewItem pour créer et initialiser un élément de menu lorsque vous construisez un menu par programme.
Le paramètre ACaption spécifie la chaîne qui doit apparaître comme élément de menu.
Le paramètre AShortCut spécifie un raccourci associé.
Le paramètre AChecked indique si l'élément de menu doit apparaître avec une marque de sélection.
Le paramètre AEnabled spécifie si l'élément de menu est activé ou estompé.
Le paramètre AOnClick spécifie le gestionnaire d'événement qui s'exécute lorsque l'utilisateur clique sur l'élément de menu.
Le paramètre hCtx spécifie l'ID de contexte d'aide pour l'élément de menu.
Le paramètre AName spécifie le nom de l'élément de menu, qui peut être utilisé pour faire référence à cet élément de menu dans le code.
L'élément de menu renvoyé par NewItem peut être ajouté à un menu en utilisant la méthode Add du parent cible. Si, à l'exécution, le menu entier est en cours de création dynamique, le nouvel élément de menu peut être ajouté à un tableau qui est transmis comme paramètre à la fonction NewMenu, NewPopupMenu ou NewSubMenu.
Avertissement : L'élément renvoyé par NewItem n'a pas de propriétaire. Vous êtes responsable de la libération de sa mémoire lorsqu'elle n'est plus nécessaire. Les méthodes Delete et Remove de TMenuItem ne libèrent pas la mémoire.