winuser.h


GetMenuDefaultItem

[Ahora soportado en Windows NT]

La función GetMenuDefaultItem determina el ítem de menú por defecto en el menú especificado.

Sintaxis

UINT WINAPI GetMenuDefaultItem(
    HMENU hMenu, 	 
    UINT fByPos, 	 
    UINT gmdiFlags	
   );

Parámetros

hMenu: manipulador de menú del que se recupera el ítem de menú por defecto.

fByPos: valor que especifica si se recupera el identificador de ítem de menú o su posición. Si este parámetro es FALSE, se devuelve el identificador. En caso contrario, se devuelve la posición.

gmdiFlags: valor que especifica el modo en que la función busca ítems de menú. Este parámetro puede ser ninguno o más de los valores siguientes:

Valor Significado
GMDI_GOINTOPOPUPS Especifica que si el ítem por defecto es uno que abre un submenú, la función debe buscar de forma recursiva en el submenú correspondiente. Si el submenú no tiene ítem por defecto, el valor de retorno identifica el ítem que abre el submenú. Por defecto, la función devuelve el primer ítem por defecto del menú especificado, independientemente de que dicho ítem abra un submenú.
GMDI_USEDISABLED Especifica que la función debe devolver un ítem, aunque esté inhibido. Por defecto, la función se salta los ítems inhibidos u oscurecidos.

Valor de retorno

Si la función tiene éxito, el valor de retorno es el identificador o posición del ítem de menú.

Si la función falla, el valor de retorno es - 1.