Função CheckDlgButton (winuser.h)

Altera o estado marcar de um controle de botão.

Sintaxe

BOOL CheckDlgButton(
  [in] HWND hDlg,
  [in] int  nIDButton,
  [in] UINT uCheck
);

[in] hDlg

Tipo: HWND

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

[in] nIDButton

Tipo: int

O identificador do botão a ser modificado.

[in] uCheck

Tipo: UINT

O estado marcar do botão. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
BST_CHECKED	Define o estado do botão como verificado.
BST_INDETERMINATE	Define o estado do botão como esmaecido, indicando um estado indeterminado. Use esse valor somente se o botão tiver o estilo BS_3STATE ou BS_AUTO3STATE .
BST_UNCHECKED	Define o estado do botão como desmarcado

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.

A função CheckDlgButton envia uma mensagem BM_SETCHECK para o controle de botão especificado na caixa de diálogo especificada.

Para obter um exemplo, consulte Criando uma caixa de diálogo Modeless em Usando caixas de diálogo.


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)

Referência