GetMenuItemInfoA-Funktion (winuser.h)

Artikel
08/27/2023

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, zu dem Informationen abgerufen werden sollen. Die Bedeutung dieses Parameters hängt vom Wert von fByPosition ab.

[in] fByPosition

Typ: BOOL

Die Bedeutung von uItem. Wenn dieser Parameter FALSE ist, 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 Informationen zum Abrufen und Empfangen von Informationen zum Menüelement angibt. Beachten Sie, dass Sie den cbSize-Member auf festlegen müssen, sizeof(MENUITEMINFO) bevor Sie diese Funktion aufrufen.

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

Um ein Menüelement vom Typ MFT_STRING abzurufen, suchen Sie zuerst die Größe der Zeichenfolge, indem Sie das dwTypeData-Element von MENUITEMINFO auf NULL festlegen und dann GetMenuItemInfo aufrufen. Der Wert von cch+1 ist die erforderliche Größe. Ordnen 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 getMenuItemInfo erneut auf, um den Puffer mit der Zeichenfolge zu füllen.

Wenn das abgerufene Menüelement von einem anderen Typ ist, legt GetMenuItemInfo das dwTypeData-Element auf einen Wert fest, dessen Typ durch das fTypefType-Element angegeben wird, und legt cch auf 0 fest.

Beispiele

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

Hinweis

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 nicht codierungsneutralem Code 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 (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-menu-l1-1-3 (eingeführt in Windows 10, Version 10.0.14393)

Siehe auch

Konzept

Menüs

Referenz

SetMenuItemInfo

Freigeben über