IsDlgButtonChecked

Syntax

WORD IsDlgButtonChecked(hDlg,nIDButton)

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.

Parameter Type/Description  

hDlg HWND Identifies the dialog box that contains the button control.  
nIDButton int 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.