CheckDlgButton (Windows Embedded CE 6.0)

1/6/2010

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

Syntax

__inline BOOL WINAPI CheckDlgButton(
  HWND hDlg,
  int nIDButton,
  UINT uCheck
);

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

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

uCheck
[in] Unsigned integer that specifies the check state for the radio button or check box. The following table shows the possible values.

Value	Description
BST_CHECKED	Sets the button state to checked.
BST_INDETERMINATE	Sets the button state to grayed, indicating an indeterminate state. Use this value only if the button has the BS_3STATE or BS_AUTO3STATE style.
BST_UNCHECKED	Sets the button state to unchecked.

This function always returns zero.

This function has no effect on push buttons.

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