CheckMenuItem

A CheckMenuItem função define o estado do atributo marca de seleção do item de menu especificado marcado ou desmarcado.

A CheckMenuItem função foi substituída pela função SetMenuItemInfo . Você pode ainda usar CheckMenuItem, no entanto, se você não precisa de nenhum dos recursos estendidos do SetMenuItemInfo.

(DWORD CheckMenuItem HMENU  hmenu, / / identificador para o menuUINTuIDCheckItem, / / menu item para marcar ou desmarcarUINTuCheck / /Flags item de menu);
 

Parâmetros

hmenu

Identificador para o menu de interesse.

uIDCheckItem

Especifica o item de menu cujo atributo marca de seleção deve ser definido, conforme determinado pelo uCheck parâmetro.

uCheck

Especifica os sinalizadores que controlam a interpretação das uIDCheckItem parâmetro e o estado do atributo de marca de seleção do item de menu. Este parâmetro pode ser uma combinação de MF_BYCOMMAND, ou MF_BYPOSITION e MF_CHECKED ou MF_UNCHECKED.

Valor	Significado
MF_BYCOMMAND	Indica que o uIDCheckItem parâmetro fornece o identificador do item de menu. O Sinalizar MF_BYCOMMAND é o padrão, se nem o MF_BYCOMMAND ou MF_BYPOSITION Sinalizar for especificado.
MF_BYPOSITION	Indica que o uIDCheckItem parâmetro dá o relativo posição baseada em zero do item de menu.
MF_CHECKED	Define o atributo marca de seleção para o estado selecionado.
MF_UNCHECKED	Define o atributo marca de seleção ao estado desmarcado.

Retornar valores

O valor de retorno especifica o estado anterior do item de menu (MF_CHECKED ou MF_UNCHECKED). Se o item de menu não existir, o valor de retorno é 0xFFFFFFFF.

Observações

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

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

Ver também

Visão geral de menus, funções de Menu, EnableMenuItem, GetMenuItemID, SetMenuItemBitmaps, SetMenuItemInfo

Index