Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Altera o estado marcar de um controle de botão.
Sintaxe
BOOL CheckDlgButton(
[in] HWND hDlg,
[in] int nIDButton,
[in] UINT uCheck
);
Parâmetros
[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 |
|---|---|
|
Define o estado do botão como verificado. |
|
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 . |
|
Define o estado do botão como desmarcado |
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, chame GetLastError.
Comentários
A função CheckDlgButton envia uma mensagem BM_SETCHECK para o controle de botão especificado na caixa de diálogo especificada.
Exemplos
Para obter um exemplo, consulte Criando uma caixa de diálogo Modeless 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
Referência