winuser.h


HiliteMenuItem

La función HiliteMenuItem resalta o elimina el resaltado de un ítem en una barra de menú.

Sintaxis

BOOL HiliteMenuItem(
    HWND hwnd,         // manipulador de ventana con el menú
    HMENU hmenu,       // manipulador del menú
    UINT uItemHilite,  // ítem de menú a resaltar o desresaltar
    UINT uHilite       // banderas de resaltado
   );

Parámetros

hwnd: identifica la ventana que contiene el menú.

hmenu: identifica la barra de menú que contiene el ítem a resaltar.

uItemHilite: especifica el ítem de menú a resaltar. Este parámetro puede ser el identificador de ítem de menú o el desplazamiento del ítem de menú en la barra de menú, dependiendo del valor del parámetro uHilite.

uHilite: especifica banderas que controlan la interpretación del parámetro uItemHilite e indica si el ítem de menú está resaltado. Este parámetro debe ser una combinación de MF_BYCOMMAND o MF_BYPOSITION y MF_HILITE o MF_UNHILITE.

Valor Significado
MF_BYCOMMAND Indica que uItemHilite contiene el identificador del ítem de menú.
MF_BYPOSITION Indica que uItemHilite contiene la posición relativa, empezando en cero, del ítem de menú.
MF_HILITE Resalta el ítem de menú. Si no se especifica esta bandera, se elimina el resaltado del ítem.
MF_UNHILITE Elimina el resaltado del ítem de menú.

Valor de retorno

Si el ítem de menú se asigna al estado de resaltado especificado, el valor de retorno es distinto de cero.

Si el ítem de menú no se resalta como se ha especificado, el valor de retorno es cero.

Observaciones

Las banderas MF_HILITE y MF_UNHILITE sólo pueden usarse con la función HiliteMenuItem; no se pueden usar con la función ModifyMenu.