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 |
|
|
Library |
|
|
DLL |
|
See also
- Reference
- CheckDlgButton
- IsDlgButtonChecked
Send comments about this topic to Microsoft
Build date: 10/27/2012
