Skip to content

Latest commit

 

History

History
107 lines (75 loc) · 3.31 KB

nf-winuser-checkradiobutton.md

File metadata and controls

107 lines (75 loc) · 3.31 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name req.apiset
NF:winuser.CheckRadioButton
CheckRadioButton function (winuser.h)
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.
CheckRadioButton
CheckRadioButton function [Windows Controls]
_win32_CheckRadioButton
_win32_CheckRadioButton_cpp
controls.CheckRadioButton
controls._win32_CheckRadioButton
winuser/CheckRadioButton
controls\CheckRadioButton.htm
Controls
VS|Controls|~\controls\buttons\buttonreference\buttonfunctions\checkradiobutton.htm
12/05/2018
CheckRadioButton, CheckRadioButton function [Windows Controls], _win32_CheckRadioButton, _win32_CheckRadioButton_cpp, controls.CheckRadioButton, controls._win32_CheckRadioButton, winuser/CheckRadioButton
winuser.h
Windows.h
Windows
Windows Vista [desktop apps only]
Windows Server 2003 [desktop apps only]
User32.lib
User32.dll
Windows
19H1
CheckRadioButton
winuser/CheckRadioButton
c++
APIRef
kbSyntax
DllExport
User32.dll
ext-ms-win-ntuser-dialogbox-l1-1-2.dll
CheckRadioButton
ext-ms-win-ntuser-dialogbox-l1-1-2 (introduced in Windows 10, version 10.0.10240)

CheckRadioButton function

-description

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.

-parameters

-param hDlg [in]

Type: HWND

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

-param nIDFirstButton [in]

Type: int

The identifier of the first radio button in the group.

-param nIDLastButton [in]

Type: int

The identifier of the last radio button in the group.

-param nIDCheckButton [in]

Type: int

The identifier of the radio button to select.

-returns

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.

-see-also

CheckDlgButton

IsDlgButtonChecked

Reference