Compartilhar via


Função GetMenuBarInfo (winuser.h)

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

GetMenu

Getsystemmenu

MENUBARINFO

Menus

Referência