Share via

Função CheckRadioButton (winuser.h)

  • Artigo

Adiciona uma marca de marcar a (verifica) um botão de opção especificado em um grupo e remove uma marca de marcar de (limpa) todos os outros botões de opção no grupo.

Sintaxe

BOOL CheckRadioButton(
  [in] HWND hDlg,
  [in] int  nIDFirstButton,
  [in] int  nIDLastButton,
  [in] int  nIDCheckButton
);

Parâmetros

[in] hDlg

Tipo: HWND

Um identificador para a caixa de diálogo que contém o botão de opção.

[in] nIDFirstButton

Tipo: int

O identificador do primeiro botão de opção no grupo.

[in] nIDLastButton

Tipo: int

O identificador do último botão de opção no grupo.

[in] nIDCheckButton

Tipo: int

O identificador do botão de opção a ser selecionado.

Retornar valor

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, chame GetLastError.

Comentários

A função CheckRadioButton envia uma mensagem BM_SETCHECK para cada um dos botões de opção no grupo indicado.

Os parâmetros nIDFirstButton e nIDLastButton especificam um intervalo de identificadores de botão (normalmente as IDs de recurso dos botões). A posição dos botões na ordem de tabulação é irrelevante; se um botão fizer parte de um grupo, mas tiver uma ID fora do intervalo especificado, ele não será afetado por essa chamada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [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-dialogbox-l1-1-2 (introduzido no Windows 10, versão 10.0.10240)

Confira também

CheckDlgButton

IsDlgButtonChecked

Referência