WinNT Sí
Win95 Sí
Win32s Sí
• Biblioteca = user32.lib • Cabecera = winuser.h
• Unicode = No
• Plataforma = Nada

CheckMenuItem

La función CheckMenuItem cambia el estado del atributo de la marca de chequeo del ítem de menú especificado a marcado o no marcado.

La función CheckMenuItem ha sido sustituida por la función SetMenuItemInfo. Aún se puede seguir usando CheckMenuItem, si no se necesita ninguna de las características extendidas de SetMenuItemInfo.

Sintaxis

DWORD CheckMenuItem(
    HMENU hmenu,        // manipulador de menú
    UINT uIDCheckItem,  // íten de menú a marcar o desmarcar
    UINT uCheck         // banderas de ítem de menú
   );

Parámetros:

hmenu: identifica el menú de interés.

uIDCheckItem: especifica el ítem de menú cuyo atributo de marca de chequeo será modificado, tal como lo indique el parámetro uCheck.

uCheck: especifica banderas que controlan la interpretación del parámetro uIDCheckItem y el estado del atributo de marca de chequeo del ítem de menú. Este parámetro puede ser una combinación de cualquiera de MF_BYCOMMAND o MF_BYPOSITION y MF_CHECKED o MF_UNCHECKED.

Valor Significado
MF_BYCOMMAND Indica que el parámetro uIDCheckItem contiene el identificador del ítem de menú. La bandera MF_BYCOMMAND es el valor por defecto, si no se especifica la bandera MF_BYCOMMAND ni MF_BYPOSITION.
MF_BYPOSITION Indica que el parámetro uIDCheckItem contiene la posición relativa empezando en cero del ítem de menú.
MF_CHECKED Asigna al atributo de marca el estado activo.
MF_UNCHECKED Asigna al atributo de marca el estado inactivo.

Valor de retorno

El valor de retorno especifica el estado previo del ítem de menú (MF_CHECKED o MF_UNCHECKED). Si el ítem de menú no existe, el valor de retorno es 0xFFFFFFFF.

Observaciones

Un ítem de la barra de menú no puede tener una marca de chequeo.

El parámetro uIDCheckItem identifica un ítem que abre un submenú o a un ítem de comando. Para un ítem que abre un submenú, el parámetro uIDCheckItem debe especificar la posición del ítem. Para un ítem de comando el parámetro uIDCheckItem puede especificar tanto la posición del ítem como su identificador.



suministrado por FreeFind
Valid HTML 4.0! Valid CSS!