CheckDlgButton

2.x

  void CheckDlgButton(hwndDlg, idButton, uCheck)    
  HWND hwndDlg; /* handle of dialog box */
  int idButton; /* button-control identifier, */  
  UINT uCheck; /* check state, */  

The CheckDlgButton function selects (places a check mark next to) or clears (removes a check mark from) a button control, or it changes the state of a three-state button.

Parameters

hwndDlg

Identifies the dialog box that contains the button.

idButton

Identifies the button to be modified.

uCheck

Specifies the check state of the button. If this parameter is nonzero, CheckDlgButton selects the button; if the parameter is zero, the function clears the button. For a three-state check box, if uCheck is 2, the button is grayed; if uCheck is 1, it is selected; if uCheck is 0, it is cleared.

Return Value

This function does not return a value.

Comments

The CheckDlgButton function sends a BM_SETCHECK message to the specified button control in the given dialog box.

See Also

CheckRadioButton, IsDlgButtonChecked