Share via

Função IsDlgButtonChecked (winuser.h)

  • Artigo

A função IsDlgButtonChecked determina se um controle de botão está marcado ou se um controle de botão de três estados está marcado, desmarcado ou indeterminado.

Sintaxe

UINT IsDlgButtonChecked(
  [in] HWND hDlg,
  [in] int  nIDButton
);

Parâmetros

[in] hDlg

Tipo: HWND

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

[in] nIDButton

Tipo: int

O identificador do controle de botão.

Valor retornado

Tipo: UINT

O valor retornado de um botão criado com os estilos BS_AUTOCHECKBOX, BS_AUTORADIOBUTTON, BS_AUTO3STATE, BS_CHECKBOX, BS_RADIOBUTTON ou BS_3STATE pode ser um dos valores na tabela a seguir. Se o botão tiver qualquer outro estilo, o valor retornado será zero.

Código de retorno Descrição
BST_CHECKED
 O botão está marcado.
BST_INDETERMINATE
 O botão está em um estado indeterminado (aplica-se somente se o botão tiver o estilo BS_3STATE ou BS_AUTO3STATE ).
BST_UNCHECKED
 O botão não está marcado.

Comentários

A função IsDlgButtonChecked envia uma mensagem BM_GETCHECK para o controle de botão especificado.

Exemplos

Para obter um exemplo, consulte a seção intitulada "Criando uma caixa de diálogo sem formatar" em Usando caixas de diálogo.

Requisitos

   
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-0 (introduzido no Windows 8)

Confira também

CheckDlgButton