AppendMenu

von ActiveVB-Team

Deklaration

Declare Function AppendMenu Lib "user32" _
                 Alias "AppendMenuA" ( _
                 ByVal hMenu As Long, _
                 ByVal wFlags As Long, _
                 ByVal wIDNewItem As Long, _
                 ByVal lpNewItem As String) As Long

Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel AppendMenu des API-Wikis.

AppendMenu ist ähnlich der Funktion InsertMenu, außer daß es die Menüelemente nur am Menüende anfügt. Menüs könnnen während der Ausführung einer Anwendung dynamisch verändert werden, um die Modifiezierungen zu berücksichtigen. Anwendungen können mit AppendMenu zur Laufzeit neue Menüs erzeugen, ohne sie vorher in Ressourcendateien aufbauen zu müssen.

Parameter
hMenu	Gibt das Handel des Menüs an, dem das neue Element hinzugefügt werden soll.
wFlags	Das ERscheinungsbild und Verhalten des neuen Menüelements. Dieser Parameter kann sich aus einem oder mehreren der in dieser Tabelle aufgeführten Werte rekrutieren. Die Flags MF_BITMAP, MF_SEPERATOR und MF_STRING können nicht kombiniert werden.
wIDNewItem	Die Menü-ID des neuen Menüelements.
lpNewItem	Der Inhalt des neuen Menüelements. Der Wert hängt vom Inhalt der des wFlag Parameters ab.

Tabelle 1

wFlags für AppenMenü
MF_BITMAP	Zeigt das Menüelement unter Verwendung einer Bitmap an. Der Parameter lpNewItem enthält das Handle für die Btimap.
MF_CHECKED	Plaziert eine Markerierung neben dem Menüelement.
MF_DISABLED	Das Menüelement steht nicht zur Auswahl zur Verfügung. Dabei wird das Menüelement nicht ausgegraut dargestellt.
MF_ENABLED	Macht das Menüelement verfügbar und löst es aus dem ausgegrauten Zustand.
MF_GRAYED	Graut das Menüelement und deaktiviert es, so daß es nicht ausgewählt werden kann.
MF_MENUBARBREAK	Plaziert das Menüelement in einer neuen Zeile, wenn es sich dabei um eine Menülesite handelt, oder eine neue Spalte, wenn es sich um ein Popup-Menü handelt. Eine vertikale Linie trennt die Spalten eines Popup-Menüs.
MF_MENUBREAK	Wie MF_MENUBARBREAK außer das die Spalten nicht durch einen vertikale Linie getrennt sind.
MF_OWNERDRAW	Fügt dem Menü ein vom Anwender gezeichnetes Menüelement hinzu. Das Fenster empfängt eine WM_MEASUREITEM Nachricht, bevor das Menü zum ersten Mal angezeigt wird, und eine WM_DRAWITEM NAchricht, wenn die Anzeige des Menüelements aktualisiert werden muß. Der Parameter lpNewItem enthält einen von der Anwendung definierten 32-Bit Wert.
MF_POPUP	Erzeugt ein Popup-Menü. Der Parameter lpNewItem enthält das Handle des Popup-Menüs.
MF_RIGHTJUSTIFY	Richtet das Menüelement und alle folgenden Elemente rechtsbündig aus. Dieses Flag ist nur gültig, wenn sich das Menüelement in der Menüleiste befindet.
MF_SEPARATOR	Gibt an, daß es sich bei dem Menüelement um eine Trennlinie handelt. Dieses Flag ist nur gültig, wenn sich das Menüelement in der Menüleiste befindet.
MF_STRING	Zeigt das Menüelement unter Verwendung eines Textstrings an. Der Parameter lpNewItem
MF_UNCHECKED	Das Menüelement besitzt keine Markierung

Tabelle 2

Rückgabewerte
1	Die Funktion wurde erfolgreich ausgeführt.
0	Es lag ein Fehler vor.

Tabelle 3

Unterstützte Betriebssysteme
Win32s, Windows 95, Windows 98, Windows NT

Verwandte API-Funktionen
CreateMenu, DeleteMenu, DestroyMenu, DrawMenuBar, InsertMenu, ModifyMenu, RemoveMenu, SetMenuItemBitmaps

Zugehörige Tipps