Función CheckMenuItem (winuser.h)

Artículo
03/15/2023

[CheckMenuItem está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. 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
);

Parámetros

[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 check-mark del elemento de menú. Este parámetro puede ser una combinación de MF_BYCOMMAND o MF_BYPOSITION y MF_CHECKED o MF_UNCHECKED.

Value	Significado
MF_BYCOMMAND 0x00000000L	Indica que el parámetro uIDCheckItem proporciona el identificador del elemento de menú. La marca MF_BYCOMMAND es la predeterminada, si no se especifica ni la marca MF_BYCOMMAND ni MF_BYPOSITION .
MF_BYPOSITION 0x00000400L	Indica que el parámetro uIDCheckItem proporciona la posición relativa de base cero del elemento de menú.
MF_CHECKED 0x00000008L	Establece el atributo check-mark en el estado seleccionado.
MF_UNCHECKED 0x00000000L	Establece el atributo check-mark en el estado claro.

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 –1.

Comentarios

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.

Ejemplos

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

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-menu-l1-1-0 (introducido en Windows 8)