CheckDlgButton (Windows CE 5.0)

Send Feedback

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

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

Parameters

  • 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.

Return Values

This function always returns zero.

Remarks

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.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Windows.h.
Link Library: Coredll.lib.

See Also

IsDlgButtonChecked | SendDlgItemMessage | BM_SETCHECK

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.