Función GetMenuDefaultItem (winuser.h)

  • Artículo

Determina el elemento de menú predeterminado en el menú especificado.

Sintaxis

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

Parámetros

[in] hMenu

Tipo: HMENU

Identificador del menú para el que se va a recuperar el elemento de menú predeterminado.

[in] fByPos

Tipo: UINT

Indica si se va a recuperar el identificador del elemento de menú o su posición. Si este parámetro es FALSE, se devuelve el identificador. De lo contrario, se devuelve la posición.

[in] gmdiFlags

Tipo: UINT

Indica cómo debe buscar la función los elementos de menú. Este parámetro puede ser cero o más de los siguientes valores.

Valor Significado
GMDI_GOINTOPOPUPS
0x0002L
 Si el elemento predeterminado es uno que abre un submenú, la función consiste en buscar de forma recursiva en el submenú correspondiente. Si el submenú no tiene ningún elemento predeterminado, el valor devuelto identifica el elemento que abre el submenú. De forma predeterminada, la función devuelve el primer elemento predeterminado del menú especificado, independientemente de si es un elemento que abre un submenú.
GMDI_USEDISABLED
0x0001L
 La función es devolver un elemento predeterminado, incluso si está deshabilitado. De forma predeterminada, la función omite los elementos deshabilitados o atenuados.

Valor devuelto

Tipo: UINT

Si la función se ejecuta correctamente, el valor devuelto es el identificador o la posición del elemento de menú.

Si se produce un error en la función, el valor devuelto es -1. Para obtener información de error extendida, llame a GetLastError.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winuser.h (incluya Windows.h)
Library User32.lib
Archivo DLL User32.dll
Conjunto de API ext-ms-win-ntuser-menu-l1-1-0 (introducido en Windows 8)

Consulte también

Conceptual

Menús

Referencia

SetMenuDefaultItem