GetMenuItemRect, fonction (winuser.h)

Récupère le rectangle englobant pour l’élément de menu spécifié.

Syntaxe

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

Paramètres

[in, optional] hWnd

Type : HWND

Handle de la fenêtre contenant le menu.

Si cette valeur est NULL et que le paramètre hMenu représente un menu contextuel, la fonction trouve la fenêtre de menu.

[in] hMenu

Type : HMENU

Handle d’un menu.

[in] uItem

Type : UINT

Position de base zéro de l’élément de menu.

[out] lprcItem

Type : LPRECT

Pointeur vers une structure RECT qui reçoit le rectangle englobant de l’élément de menu spécifié exprimé en coordonnées d’écran.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, utilisez la fonction GetLastError .

Remarques

Pour que le rectangle retourné soit significatif, le menu doit apparaître dans un menu contextuel ou attaché à une fenêtre si une barre de menus. Les positions des éléments de menu ne sont pas déterminées tant que le menu n’est pas affiché.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête winuser.h (inclure Windows.h)
Bibliothèque User32.lib
DLL User32.dll

Voir aussi

Menus