Função CheckMenuItem (winuser.h)

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

Define o estado do atributo de marca de seleção do item de menu especificado como selecionado ou desmarcado.

Sintaxe

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

Parameters

[in] hMenu

Tipo: HMENU

Um identificador para o menu de interesse.

[in] uIDCheckItem

Tipo: UINT

O item de menu cujo atributo de marca de seleção 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 seleção 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 de devolução

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á UINT_MAX.

Observações

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

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.

Requirements

Consulte também

Conceitual

EnableMenuItem

GetMenuItemID

menus

Referência

SetMenuItemBitmaps

Setmenuiteminfo