Função CheckMenuItem (winuser.h)

Artigo
08/27/2023

[CheckMenuItem está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use SetMenuItemInfo. ]

Define o estado do atributo de marca de marcar do item de menu especificado como selecionado ou desmarcado.

Sintaxe

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

Parâmetros

[in] hMenu

Tipo: HMENU

Um identificador para o menu de interesse.

[in] uIDCheckItem

Tipo: UINT

O item de menu cujo atributo de marca de marcar deve ser definido, conforme determinado pelo parâmetro uCheck.

[in] uCheck

Tipo: UINT

Os sinalizadores que controlam a interpretação do parâmetro uIDCheckItem e o estado do atributo de marca de marcar do item de menu. Esse parâmetro pode ser uma combinação de MF_BYCOMMAND ou MF_BYPOSITION e MF_CHECKED ou MF_UNCHECKED.

Valor	Significado
MF_BYCOMMAND 0x00000000L	Indica que o parâmetro uIDCheckItem fornece o identificador do item de menu. O sinalizador MF_BYCOMMAND será o padrão, se nem o sinalizador MF_BYCOMMAND nem MF_BYPOSITION for especificado.
MF_BYPOSITION 0x00000400L	Indica que o parâmetro uIDCheckItem fornece a posição relativa baseada em zero do item de menu.
MF_CHECKED 0x00000008L	Define o atributo de marca de marcar para o estado selecionado.
MF_UNCHECKED 0x00000000L	Define o atributo de marca de marcar como o estado claro.

Valor retornado

Tipo: DWORD

O valor retornado especifica o estado anterior do item de menu ( MF_CHECKED ou MF_UNCHECKED). Se o item de menu não existir, o valor retornado será –1.

Comentários

Um item em uma barra de menus não pode ter uma marca de marcar.

O parâmetro uIDCheckItem identifica um item que abre um submenu ou um item de comando. Para um item que abre um submenu, o parâmetro uIDCheckItem deve especificar a posição do item. Para um item de comando, o parâmetro uIDCheckItem pode especificar a posição do item ou seu identificador.

Exemplos

Para obter um exemplo, consulte Simulando caixas de seleção em um menu.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-menu-l1-1-0 (introduzido no Windows 8)