InsertMenuItemA-Funktion (winuser.h)

Artikel
11/20/2024

Fügt ein neues Menüelement an der angegebenen Position in einem Menü ein.

Syntax

BOOL InsertMenuItemA(
  [in] HMENU            hmenu,
  [in] UINT             item,
  [in] BOOL             fByPosition,
  [in] LPCMENUITEMINFOA lpmi
);

Parameter

[in] hmenu

Typ: HMENU

Ein Handle für das Menü, in das das neue Menüelement eingefügt wird.

[in] item

Typ: UINT-

Der Bezeichner oder die Position des Menüelements, vor dem das neue Element eingefügt werden soll. Die Bedeutung dieses Parameters hängt vom Wert fByPositionab.

[in] fByPosition

Typ: BOOL-

Steuert die Bedeutung von Element. Wenn dieser Parameter FALSEist, ist Element ein Menüelementbezeichner. Andernfalls handelt es sich um eine Menüelementposition. Weitere Informationen finden Sie unter Programmgesteuertes Zugreifen auf Menüelemente.

[in] lpmi

Typ: LPCMENUITEMINFO

Ein Zeiger auf eine MENUITEMINFO Struktur, die Informationen zum neuen Menüelement enthält.

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. Verwenden Sie zum Abrufen erweiterter Fehlerinformationen die GetLastError--Funktion.

Bemerkungen

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

Damit Tastenkombinationen mit Bitmap- oder vom Besitzer gezeichneten Menüelementen verwendet werden können, muss der Besitzer des Menüs die WM_MENUCHAR Nachricht verarbeiten. Weitere Informationen finden Sie unter Owner-Drawn Menüs und der WM_MENUCHAR Nachrichten-.

Beispiele

Ein Beispiel finden Sie unter Beispiel für Menu-Item Bitmaps-.

Anmerkung

Der winuser.h-Header definiert InsertMenuItem 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-1 (eingeführt in Windows 8.1)