InsertMenuItemA-Funktion (winuser.h)

Artikel
08/27/2023

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 von fByPosition ab.

[in] fByPosition

Typ: BOOL

Steuert die Bedeutung des Elements. Wenn dieser Parameter FALSE ist, ist item 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 fehlerhaft ist, ist der Rückgabewert null. Verwenden Sie die GetLastError-Funktion , um erweiterte Fehlerinformationen abzurufen.

Hinweise

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

Damit Tastenkombinationen mit Bitmap- oder von Besitzern gezeichneten Menüelementen funktionieren, muss der Besitzer des Menüs die WM_MENUCHAR Nachricht verarbeiten. Weitere Informationen finden Sie unter Vom Besitzer gezeichnete Menüs und die WM_MENUCHAR Meldung .

Beispiele

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

Hinweis

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


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-menu-l1-1-1 (eingeführt in Windows 8.1)