Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
MSDN Library
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.


Windows Mobile 6.5
A version of this page is also available for

This inline function retrieves the check state of a radio button or check box in a specified dialog box.

__inline UINT WINAPI IsDlgButtonChecked(
  HWND hDlg,
  int nIDButton


[in] Handle to the dialog box that contains the radio button or check box.


[in] Integer that specifies the identifier of the radio button or check box for which you want to retrieve the check state.

The following table shows the possible return values if you created the button with the BS_AUTOCHECKBOX, BS_AUTORADIOBUTTON, BS_AUTO3STATE, BS_CHECKBOX, BS_RADIOBUTTON, or BS_3STATE style.

Value Description


The button is checked.


The button is grayed, indicating an indeterminate state. This value applies only if the button has the BS_3STATE or BS_AUTO3STATE style.


The button is unchecked.

If the button has any other style, the return value is zero.

This function uses the SendDlgItemMessage function to send a BM_GETCHECK message to the specified button control in the specified dialog box.

Windows Embedded CEWindows CE .NET 4.0 and later
Windows MobileWindows Mobile Version 5.0 and later

Community Additions

© 2015 Microsoft