Função GetMenuBarInfo (winuser.h)

Artigo
08/27/2023

Recupera informações sobre a barra de menus especifica.

Sintaxe

BOOL GetMenuBarInfo(
  [in]      HWND         hwnd,
  [in]      LONG         idObject,
  [in]      LONG         idItem,
  [in, out] PMENUBARINFO pmbi
);

Parâmetros

[in] hwnd

Digite: HWND

Um identificador para a janela (barra de menus) cujas informações devem ser recuperadas.

[in] idObject

Tipo: LONG

O objeto de menu. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
OBJID_CLIENT ((LONG)0xFFFFFFFC)	O menu pop-up associado à janela.
OBJID_MENU ((LONG)0xFFFFFFFD)	A barra de menus associada à janela (consulte a função GetMenu ).
OBJID_SYSMENU ((LONG)0xFFFFFFFF)	O menu do sistema associado à janela (consulte a função GetSystemMenu ).

[in] idItem

Tipo: LONG

O item para o qual recuperar informações. Se esse parâmetro for zero, a função recuperará informações sobre o próprio menu. Se esse parâmetro for 1, a função recuperará informações sobre o primeiro item no menu, e assim por diante.

[in, out] pmbi

Tipo: PMENUBARINFO

Um ponteiro para uma estrutura MENUBARINFO que recebe as informações. Observe que você deve definir o membro cbSize como sizeof(MENUBARINFO) antes de chamar essa função.

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, chame GetLastError.

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
Conjunto de APIs	ext-ms-win-ntuser-misc-l1-5-0 (introduzido no Windows 10, versão 10.0.10240)

Confira também

Conceitual

Referência