Compartilhar via

Função CheckMenuRadioItem (winuser.h)

  • Artigo

Seleciona um item de menu especificado e o torna um item de opção. Ao mesmo tempo, a função limpa todos os outros itens de menu no grupo associado e limpa o sinalizador de tipo de item de rádio para esses itens.

Sintaxe

BOOL CheckMenuRadioItem(
  [in] HMENU hmenu,
  [in] UINT  first,
  [in] UINT  last,
  [in] UINT  check,
  [in] UINT  flags
);

Parâmetros

[in] hmenu

Tipo: HMENU

Um identificador para o menu que contém o grupo de itens de menu.

[in] first

Tipo: UINT

O identificador ou a posição do primeiro item de menu no grupo.

[in] last

Tipo: UINT

O identificador ou a posição do último item de menu no grupo.

[in] check

Tipo: UINT

O identificador ou a posição do item de menu a ser marcar.

[in] flags

Tipo: UINT

Indica o significado de idFirst, idLast e idCheck. Se esse parâmetro for MF_BYCOMMAND, os outros parâmetros especificarão identificadores de item de menu. Se for MF_BYPOSITION, os outros parâmetros especificarão as posições do item de menu.

Valor retornado

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, use a função GetLastError .

Comentários

A função CheckMenuRadioItem define o sinalizador de tipo MFT_RADIOCHECK e o estado MFS_CHECKED para o item especificado por idCheck e, ao mesmo tempo, limpa os dois sinalizadores para todos os outros itens do grupo. O item selecionado é exibido usando um bitmap de marcador em vez de um bitmap de marca marcar.

Para obter mais informações sobre o tipo de item de menu e os sinalizadores de estado, consulte a estrutura MENUITEMINFO .

Exemplos

Para obter um exemplo, consulte Exemplo de como usar bitmaps de marca de seleção personalizada.

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)

Confira também

Conceitual

MENUITEMINFO

Menus

Referência