Compartilhar via


Função GetMenuItemRect (winuser.h)

Recupera o retângulo delimitador para o item de menu especificado.

Sintaxe

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

Parâmetros

[in, optional] hWnd

Digite: HWND

Um identificador para a janela que contém o menu.

Se esse valor for NULL e o parâmetro hMenu representar um menu pop-up, a função encontrará a janela de menu.

[in] hMenu

Tipo: HMENU

Um identificador para um menu.

[in] uItem

Tipo: UINT

A posição baseada em zero do item de menu.

[out] lprcItem

Tipo: LPRECT

Um ponteiro para uma estrutura RECT que recebe o retângulo delimitador do item de menu especificado expresso em coordenadas de tela.

Retornar valor

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, use a função GetLastError .

Comentários

Para que o retângulo retornado seja significativo, o menu deverá ser exibido se um menu pop-up ou anexado a uma janela, se uma barra de menus. As posições do item de menu não são determinadas até que o menu seja exibido.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll

Confira também

Menus