IsDlgButtonChecked

Overview

Group

Quick Info

Windows NT
Yes
Win95
Yes
Win32s
Yes
Import Library
user32.lib
Header File
winuser.h
Unicode
No
Platform Notes
None

The IsDlgButtonChecked function determines whether a button control has a check mark next to it or whether a three-state button control is grayed, checked, or neither.

UINT IsDlgButtonChecked(

HWND hDlg,	// handle of dialog box
int nIDButton	// button identifier
);

Parameters
hDlg

Identifies the dialog box that contains the button control.

nIDButton

Specifies the integer identifier of the button control.

Return Values
The return value from a button created with the BS_AUTOCHECKBOX, BS_AUTORADIOBUTTON, BS_AUTO3STATE, BS_CHECKBOX, BS_RADIOBUTTON, or BS_3STATE style can be one of the following:

Value	Meaning
BST_CHECKED	Button is checked.
BST_INDETERMINATE	Button is grayed, indicating an indeterminate state (applies only if the button has the BS_3STATE or BS_AUTO3STATE style).
BST_UNCHECKED	Button is unchecked

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

Remarks
The IsDlgButtonChecked function sends a BM_GETCHECK message to the specified button control.