Função GetMenuDefaultItem (winuser.h)

Artigo
03/04/2024

Determina o item de menu padrão no menu especificado.

Sintaxe

UINT GetMenuDefaultItem(
  [in] HMENU hMenu,
  [in] UINT  fByPos,
  [in] UINT  gmdiFlags
);

Parâmetros

[in] hMenu

Tipo: HMENU

Um identificador para o menu para o qual recuperar o item de menu padrão.

[in] fByPos

Tipo: UINT

Indica se o identificador do item de menu ou sua posição deve ser recuperado. Se esse parâmetro for FALSE, o identificador será retornado. Caso contrário, a posição será retornada.

[in] gmdiFlags

Tipo: UINT

Indica como a função deve pesquisar itens de menu. Esse parâmetro pode ser zero ou mais dos valores a seguir.

Valor	Significado
GMDI_GOINTOPOPUPS 0x0002L	Se o item padrão for aquele que abre um submenu, a função será pesquisar recursivamente no submenu correspondente. Se o submenu não tiver nenhum item padrão, o valor retornado identificará o item que abre o submenu. Por padrão, a função retorna o primeiro item padrão no menu especificado, independentemente de ser um item que abre um submenu.
GMDI_USEDISABLED 0x0001L	A função é retornar um item padrão, mesmo que esteja desabilitado. Por padrão, a função ignora itens desabilitados ou esmaecidos.

Retornar valor

Tipo: UINT

Se a função for bem-sucedida, o valor retornado será o identificador ou a posição do item de menu.

Se a função falhar, o valor retornado será -1. 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-menu-l1-1-0 (introduzido no Windows 8)

Confira também

Conceitual

Referência

Setmenudefaultitem