Compartilhar via


CWnd::CheckDlgButton

Seleciona um local (a marca de seleção ao lado de) ou limpa (remove uma marca de seleção de um botão), ou alterar o estado de um botão de três estado.

void CheckDlgButton( 
   int nIDButton, 
   UINT nCheck  
);

Parâmetros

  • nIDButton
    Especifica o botão seja alterado.

  • nCheck
    Especifica a ação executar. Se nCheck é diferente de zero, a função de membro de CheckDlgButton coloca uma marca de seleção ao lado do botão; se 0, a marca de seleção são removidos. Para os botões de três estados, se nCheck é 2, o estado do botão é indefinido.

Comentários

A função de CheckDlgButton envia uma mensagem de BM_SETCHECK o botão especificado.

Exemplo

// Sets 3 check buttons in various ways.  Note BST_INDETERMINATE 
// requires BS_3STATE or BS_AUTO3STATE in the button's style. 
void CMyDlg::OnMarkButtons() 
{
   CheckDlgButton(IDC_CHECK1, BST_UNCHECKED);   // 0
   CheckDlgButton(IDC_CHECK2, BST_CHECKED);   // 1
   CheckDlgButton(IDC_CHECK3, BST_INDETERMINATE);   // 2
}

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CWnd Class

Gráfico da hierarquia

CWnd::IsDlgButtonChecked

CButton::SetCheck

CheckDlgButton