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.