Share via


GetMenuItemRect-Funktion (winuser.h)

Ruft das umgebende Rechteck für das angegebene Menüelement ab.

Syntax

BOOL GetMenuItemRect(
  [in, optional] HWND   hWnd,
  [in]           HMENU  hMenu,
  [in]           UINT   uItem,
  [out]          LPRECT lprcItem
);

Parameter

[in, optional] hWnd

Typ: HWND

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

Wenn dieser Wert NULL ist und der hMenu-Parameter ein Popupmenü darstellt, sucht die Funktion das Menüfenster.

[in] hMenu

Typ: HMENU

Ein Handle für ein Menü.

[in] uItem

Typ: UINT

Die nullbasierte Position des Menüelements.

[out] lprcItem

Typ: LPRECT

Ein Zeiger auf eine RECT-Struktur , die das umgebende Rechteck des angegebenen Menüelements empfängt, ausgedrückt in Bildschirmkoordinaten.

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

Damit das zurückgegebene Rechteck aussagekräftig ist, muss das Menü angezeigt werden, wenn ein Popupmenü vorhanden ist, oder an ein Fenster angefügt werden, wenn eine Menüleiste. Die Positionen von Menüelementen werden erst bestimmt, wenn das Menü angezeigt wird.

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

Weitere Informationen

Menüs