SetMenuItemInfoA-Funktion (winuser.h)

Artikel
08/28/2023

Ändert Informationen zu einem Menüelement.

Syntax

BOOL SetMenuItemInfoA(
  [in] HMENU            hmenu,
  [in] UINT             item,
       BOOL             fByPositon,
  [in] LPCMENUITEMINFOA lpmii
);

Parameter

[in] hmenu

Typ: HMENU

Ein Handle für das Menü, das das Menüelement enthält.

[in] item

Typ: UINT

Der Bezeichner oder die Position des zu ändernden Menüelements. Die Bedeutung dieses Parameters hängt vom Wert von fByPosition ab.

fByPositon

[in] lpmii

Typ: LPMENUITEMINFO

Ein Zeiger auf eine MENUITEMINFO-Struktur , die Informationen zum Menüelement enthält und angibt, welche Menüelementattribute geändert werden sollen.

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 Owner-Drawn Menüelemente.

Hinweis

Der winuser.h-Header definiert SetMenuItemInfo 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
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-0 (eingeführt in Windows 8)