IsDlgButtonChecked

  UINT IsDlgButtonChecked(hwndDlg, nIDButton)    
  HWND hwndDlg; /* handle of dialog box */
  int nIDButton; /* button identifier */

This function determines whether a button control has a checkmark next to it, and whether a three-state button control is grayed, checked, or neither. The IsDlgButtonChecked function sends a BM_GETCHECK message to the button control.

Parameters

hwndDlg

Identifies the dialog box that contains the button control.

nIDButton

Specifies the integer identifier of the button control.

Return Value

The return value specifies the outcome of the function. It is nonzero if the given control has a checkmark next to it. Otherwise, it is zero. For three-state buttons, the return value is 2 if the button is grayed, 1 if the button has a checkmark next to it, and zero otherwise.

See Also

CheckDlgButton