Função IsDlgButtonChecked (winuser.h)
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 |
---|---|
|
O botão está marcado. |
|
O botão está em um estado indeterminado (aplica-se somente se o botão tiver o estilo BS_3STATE ou BS_AUTO3STATE ). |
|
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) |