WinMenuItemAdd

obj -> WinMenuItemAdd([alpha1[, alpha2[, int3]]]) : handle

Menüeintrag zu Menü hinzufügen

Details

• obj: Menü
• alpha1: Menüeintragsname (optional)
• alpha2: Menüeintragstitel (optional)
• int3: Menüeintragsposition (optional)
• Resultat: handle Deskriptor des neuen Menüeintrags
• Siehe: Verwandte Befehle

Dieser Befehl fügt einen Menüeintrag zu einem Menü-Objekt (obj) hinzu. Wird in (obj) ein Menü oder ein Kontextmenüs übergeben, wird der Menüeintrag in der ersten Ebene angelegt. Handelt es sich um ein Menü, wird der Eintrag in der Menüzeile angelegt.

info

Bei einem Kontextmenü muss das Anlegen eines Menüeintrags in dem Ereignis EvtMenuInitPopup vorgenommen werden.

Bei der Übergabe eines bestehenden Menüeintrags in (obj) wird in dessen Untermenü der neue Eintrag hinzugefügt. Existiert noch kein Untermenü, wird ein neues angelegt. In (int3) wird die Position des Menüeintrags angegeben. Wird hier 0 angegeben oder kein Parameter angegeben, wird der Eintrag immer am Ende hinzugefügt. Name (alpha1) (siehe Name) und Titel (alpha2) (siehe Caption) können direkt beim Aufruf bestimmt werden, alle weiteren Eingenschaften müssen mit Hilfe des Resultats gesetzt werden.

Als Resultat wird der Deskriptor des neuen Menüeintrags zurückgeliefert. Im Fehlerfall ist das Ergebnis 0.

Beispiel:

// Menüeintrag 'Kopieren' zu Menü tMenuItemEdit hinzufügen
tMenuItem # tMenuItemEdit->WinMenuItemAdd('miEditCopy', '&Kopieren');

// Menüeintrag 'Neu' an Position zwei erzeugen
tMenuItem # tMenuItemEdit->WinMenuItemAdd('miEditNew', '&Neu', 2);