Compartilhar via


CMenu::CheckMenuItem

Adicionar marcas de seleção para ou remove as marcas de seleção de itens de menu no menu pop-up.

UINT CheckMenuItem( 
   UINT nIDCheckItem, 
   UINT nCheck  
);

Parâmetros

  • nIDCheckItem
    Especifica o item de menu a ser verificado, conforme determinado por nCheck.

  • nCheck
    Especifica como verificar o item de menu e como determinar a posição do item no menu. o parâmetro de nCheck pode ser uma combinação de MF_CHECKED ou de MF_UNCHECKED com os sinalizadores de MF_BYPOSITION ou de MF_BYCOMMAND . Esses sinalizadores podem ser combinados usando o operador OR bit a bit. Têm significados os seguintes:

    • MF_BYCOMMAND especifica que o parâmetro fornece a identificação do comando de menu item existente. Esse é o padrão.

    • MF_BYPOSITION especifica que o parâmetro retorna a posição do item de menu existente. O primeiro item está na posição 0.

    • MF_CHECKED atua como uma alternância com MF_UNCHECKED para colocar a marca de seleção padrão ao lado do item.

    • MF_UNCHECKED atua como uma alternância com MF_CHECKED para remover uma marca de seleção próxima ao item.

Valor de retorno

O estado do item anterior: MF_CHECKED ou MF_UNCHECKED, ou 0xFFFFFFFF se o item de menu não exista.

Comentários

o parâmetro de nIDCheckItem especifica o item a ser alterado.

O parâmetro de nIDCheckItem pode identificar um item de menu pop-up bem como um item de menu. Nenhuma etapa especial é necessária para verificar um item de menu pop-up. Os itens de menu de nível superior não podem ser verificadas. Um item de menu pop-up deve ser verificado pela posição pois não tem um identificador do item de menu associado a ele.

Exemplo

Consulte o exemplo para CMenu::GetMenuState.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CMenu

Gráfico da hierarquia

CMenu::GetMenuState

CheckMenuItem

CMenu::CheckMenuRadioItem