SetMenuItemInfoA-Funktion (winuser.h)

Artikel
11/20/2024

Ä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 fByPositionab.

fByPositon

[in] lpmii

Typ: LPMENUITEMINFO

Ein Zeiger auf eine MENUITEMINFO Struktur, die Informationen zum Menüelement enthält, und gibt an, 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 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 Owner-Drawn Menüelemente.

Anmerkung

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
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)