Função CheckMenuItem (winuser.h)

[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 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

Confira também

Conceitual

Enablemenuitem

GetMenuItemID

Menus

Referência

SetMenuItemBitmaps

Setmenuiteminfo