IsDlgButtonChecked

A função IsDlgButtonChecked determina se um Controlarar de botão tem uma marca de seleção próximo a ele ou se um Controlarar de botão de três Estados é acinzentado, marcado, ou nenhuma das duas.

(UINT IsDlgButtonChecked HWND  hDlg, / / manipular a caixa de diálogointnIDButton / / botão identificador);
 

Parâmetros

hDlg
Identificador para a caixa de diálogo que contém o Controlarar de botão.
nIDButton
Especifica o identificador inteiro do Controlarar button.

Retornar valores

O valor de retorno de um botão criado com BS_AUTOCHECKBOX, BS_AUTORADIOBUTTON, BS_AUTO3STATE, BS_CHECKBOX, BS_RADIOBUTTON ou BS_3STATE estilo pode ser uma das seguintes:

Valor Significado
BST_CHECKED Botão é marcado.
BST_INDETERMINATE Botão está cinza, indicando um estado indeterminado (aplicável somente se o botão tem o estilo BS_3STATE ou BS_AUTO3STATE).
BST_UNCHECKED Botão está desmarcado

Se o botão tiver qualquer outro estilo, o valor de retorno é zero.

Observações

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

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral de botões, funções de botão, CheckDlgButton

Index