Función CheckMenuItem (winuser.h)

[CheckMenuItem está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores. En su lugar, use SetMenuItemInfo. ]

Establece el estado del atributo de marca de verificación del elemento de menú especificado en seleccionado o desactivado.

Sintaxis

DWORD CheckMenuItem(
  [in] HMENU hMenu,
  [in] UINT  uIDCheckItem,
  [in] UINT  uCheck
);

Parameters

[in] hMenu

Tipo: HMENU

Identificador del menú de interés.

[in] uIDCheckItem

Tipo: UINT

Elemento de menú cuyo atributo de marca de verificación se va a establecer, determinado por el parámetro uCheck .

[in] uCheck

Tipo: UINT

Marcas que controlan la interpretación del parámetro uIDCheckItem y el estado del atributo de marca de verificación del elemento de menú. Este parámetro puede ser una combinación de MF_BYCOMMAND o MF_BYPOSITION y MF_CHECKED o MF_UNCHECKED.

Valor devuelto

Tipo: DWORD

El valor devuelto especifica el estado anterior del elemento de menú (ya sea MF_CHECKED o MF_UNCHECKED). Si el elemento de menú no existe, el valor devuelto es UINT_MAX.

Observaciones

Un elemento de una barra de menús no puede tener una marca de verificación.

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

Examples

Para obtener un ejemplo, vea Simulación de casillas en un menú.

Requisitos

Consulte también

conceptual de

EnableMenuItem

GetMenuItemID

Menús

Referencia

SetMenuItemBitmaps

SetMenuItemInfo