Export (0) Print
Expand All

CheckRadioButton function

Adds a check mark to (checks) a specified radio button in a group and removes a check mark from (clears) all other radio buttons in the group.

Syntax


BOOL CheckRadioButton(
  _In_  HWND hDlg,
  _In_  int nIDFirstButton,
  _In_  int nIDLastButton,
  _In_  int nIDCheckButton
);

Parameters

hDlg [in]

Type: HWND

A handle to the dialog box that contains the radio button.

nIDFirstButton [in]

Type: int

The identifier of the first radio button in the group.

nIDLastButton [in]

Type: int

The identifier of the last radio button in the group.

nIDCheckButton [in]

Type: int

The identifier of the radio button to select.

Return value

Type: BOOL

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The CheckRadioButton function sends a BM_SETCHECK message to each of the radio buttons in the indicated group.

The nIDFirstButton and nIDLastButton parameters specify a range of button identifiers (normally the resource IDs of the buttons). The position of buttons in the tab order is irrelevant; if a button forms part of a group, but has an ID outside the specified range, it is not affected by this call.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winuser.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

See also

Reference
CheckDlgButton
IsDlgButtonChecked

 

 

Community Additions

ADD
Show:
© 2014 Microsoft