GetMenuItemInfoA-Funktion (winuser.h)

Artikel
11/20/2024

Ruft Informationen zu einem Menüelement ab.

Syntax

BOOL GetMenuItemInfoA(
  [in]      HMENU           hmenu,
  [in]      UINT            item,
  [in]      BOOL            fByPosition,
  [in, out] LPMENUITEMINFOA 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 Menüelements zum Abrufen von Informationen. Die Bedeutung dieses Parameters hängt vom Wert fByPositionab.

[in] fByPosition

Typ: BOOL-

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

[in, out] lpmii

Typ: LPMENUITEMINFO

Ein Zeiger auf eine MENUITEMINFO- Struktur, die die abzurufenden und empfangenden Informationen zum Menüelement angibt. Beachten Sie, dass Sie das cbSize Member auf sizeof(MENUITEMINFO) festlegen müssen, bevor Sie diese Funktion aufrufen.

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

Um ein Menüelement vom Typ MFT_STRINGabzurufen, suchen Sie zuerst die Größe der Zeichenfolge, indem Sie das dwTypeData Member von MENUITEMINFO auf NULL- und dann GetMenuItemInfoaufrufen. Der Wert cch+1 ist die erforderliche Größe. Weisen Sie dann einen Puffer dieser Größe zu, platzieren Sie den Zeiger auf den Puffer in dwTypeData-, erhöhen sie cch um eins, und rufen Sie dann GetMenuItemInfo erneut auf, um den Puffer mit der Zeichenfolge auszufüllen.

Wenn das abgerufene Menüelement einen anderen Typ aufweist, legt GetMenuItemInfo das dwTypeData-element auf einen Wert fest, dessen Typ durch den fTypefType Member angegeben wird, und legt cch auf 0 fest.

Beispiele

Ein Beispiel finden Sie unter Beispiel für Owner-Drawn Menüelemente.

Anmerkung

Der winuser.h-Header definiert GetMenuItemInfo 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-3 (eingeführt in Windows 10, Version 10.0.14393)

Siehe auch

Konzeptionelle

Menüs

Referenz-

SetMenuItemInfo-

Freigeben über