AppendMenuA-Funktion (winuser.h)

Artikel
11/20/2024

Fügt ein neues Element am Ende der angegebenen Menüleiste, des Dropdownmenüs, des Untermenüs oder des Kontextmenüs an. Mit dieser Funktion können Sie den Inhalt, die Darstellung und das Verhalten des Menüelements angeben.

Syntax

BOOL AppendMenuA(
  [in]           HMENU    hMenu,
  [in]           UINT     uFlags,
  [in]           UINT_PTR uIDNewItem,
  [in, optional] LPCSTR   lpNewItem
);

Parameter

[in] hMenu

Typ: HMENU

Ein Handle für die Menüleiste, das Dropdownmenü, das Untermenü oder das Kontextmenü, das geändert werden soll.

[in] uFlags

Typ: UINT-

Steuert die Darstellung und das Verhalten des neuen Menüelements. Dieser Parameter kann eine Kombination aus den folgenden Werten sein.

Wert	Bedeutung
MF_BITMAP 0x00000004L	Verwendet eine Bitmap als Menüelement. Der lpNewItem--Parameter enthält ein Handle für die Bitmap.
MF_CHECKED 0x00000008L	Platziert ein Häkchen neben dem Menüelement. Wenn die Anwendung Häkchenbitmaps bereitstellt (siehe SetMenuItemBitmaps, zeigt dieses Flag die Häkchen-Bitmap neben dem Menüelement an.
MF_DISABLED 0x000000002L	Deaktiviert das Menüelement, sodass es nicht ausgewählt werden kann, aber das Flag nicht grau.
MF_ENABLED 0x000000000L	Aktiviert das Menüelement, damit es ausgewählt werden kann, und stellt es aus dem grauen Zustand wieder her.
MF_GRAYED 0x00000001L	Deaktiviert das Menüelement und graut es, sodass es nicht ausgewählt werden kann.
MF_MENUBARBREAK 0x000000020L	Funktioniert mit der MF_MENUBREAK-Kennzeichnung für eine Menüleiste. Bei einem Dropdownmenü, untermenü oder Kontextmenü wird die neue Spalte durch eine vertikale Linie von der alten Spalte getrennt.
MF_MENUBREAK 0x00000040L	Platziert das Element in einer neuen Zeile (für eine Menüleiste) oder in einer neuen Spalte (für ein Dropdownmenü, Untermenü oder Kontextmenü), ohne Spalten zu trennen.
MF_OWNERDRAW 0x00000100L	Gibt an, dass es sich bei dem Element um ein vom Besitzer gezeichnetes Element handelt. Bevor das Menü zum ersten Mal angezeigt wird, empfängt das Fenster, das das Menü besitzt, eine WM_MEASUREITEM Nachricht, um die Breite und Höhe des Menüelements abzurufen. Die WM_DRAWITEM Nachricht wird dann an die Fensterprozedur des Besitzerfensters gesendet, wenn die Darstellung des Menüelements aktualisiert werden muss.
MF_POPUP 0x000000010L	Gibt an, dass das Menüelement ein Dropdownmenü oder untermenü öffnet. Der parameter uIDNewItem gibt ein Handle für das Dropdownmenü oder untermenü an. Diese Kennzeichnung wird verwendet, um einer Menüleiste einen Menünamen oder ein Menüelement hinzuzufügen, das ein Untermenü zu einem Dropdownmenü, Untermenü oder Kontextmenü öffnet.
MF_SEPARATOR 0x00000800L	Zeichnet eine horizontale Trennlinie. Diese Kennzeichnung wird nur in einem Dropdownmenü, Untermenü oder Kontextmenü verwendet. Die Linie kann nicht grau, deaktiviert oder hervorgehoben werden. Die parameter lpNewItem und uIDNewItem werden ignoriert.
MF_STRING 0x000000000L	Gibt an, dass das Menüelement eine Textzeichenfolge ist; der parameter lpNewItem ist ein Zeiger auf die Zeichenfolge.
MF_UNCHECKED 0x000000000L	Platziert kein Häkchen neben dem Element (Standardeinstellung). Wenn die Anwendung Häkchenbitmaps bereitstellt (siehe SetMenuItemBitmaps), zeigt dieses Flag die klare Bitmap neben dem Menüelement an.

[in] uIDNewItem

Typ: UINT_PTR

Der Bezeichner des neuen Menüelements oder, wenn der uFlags Parameter auf MF_POPUPfestgelegt ist, ein Handle für das Dropdownmenü oder untermenü.

[in, optional] lpNewItem

Typ: LPCTSTR-

Der Inhalt des neuen Menüelements. Die Interpretation von lpNewItem hängt davon ab, ob der uFlags Parameter die folgenden Werte enthält.

Wert	Bedeutung
MF_BITMAP 0x00000004L	Enthält ein Bitmaphandle.
MF_OWNERDRAW 0x00000100L	Enthält einen vom Anwendung bereitgestellten Wert, mit dem zusätzliche Daten im Zusammenhang mit dem Menüelement verwaltet werden können. Der Wert befindet sich im itemData- Element der Struktur, auf das durch den lParam Parameter der WM_MEASUREITEM oder WM_DRAWITEM Nachricht verwiesen wird, die gesendet wird, wenn das Menü erstellt oder die Darstellung aktualisiert wird.
MF_STRING 0x000000000L	Enthält einen Zeiger auf eine mit Null beendete Zeichenfolge.

Rückgabewert

Typ: BOOL-

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null. Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Die Anwendung muss die DrawMenuBar- Funktion aufrufen, wenn sich ein Menü ändert, ob sich das Menü in einem angezeigten Fenster befindet.

Um Zugriffstasten für die Arbeit mit Bitmap- oder besitzergezeichneten Menüelementen zu erhalten, muss der Besitzer des Menüs die WM_MENUCHAR Nachricht verarbeiten. Weitere Informationen finden Sie unter Owner-Drawn Menüs und der WM_MENUCHAR Nachricht.

Die folgenden Flaggruppen können nicht zusammen verwendet werden:

MF_BITMAP, MF_STRINGund MF_OWNERDRAW
MF_CHECKED und MF_UNCHECKED
MF_DISABLED, MF_ENABLEDund MF_GRAYED
MF_MENUBARBREAK und MF_MENUBREAK

Beispiele

Ein Beispiel finden Sie unter Hinzufügen von Linien und Diagrammen zu einem Menü.

Anmerkung

Der winuser.h-Header definiert AppendMenu als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winuser.h (enthalten Windows.h)
Library	User32.lib
DLL-	User32.dll
API-Satz	ext-ms-win-ntuser-menu-l1-1-0 (eingeführt in Windows 8)