wxRadioButton

A radio button item is a button which usually denotes one of several mutually exclusive options. It has a text label next to a (usually) round button.

You can create a group of mutually-exclusive radio buttons by specifying wxRB_GROUP for the first in the group. The group ends when another radio button group is created, or there are no more radio buttons.

Derived from

wxControl
wxWindow
wxEvtHandler
wxObject

Include files

<wx/radiobut.h>

Window styles

wxRB_GROUP Marks the beginning of a new group of radio buttons.
wxRB_SINGLE In some circumstances, radio buttons that are not consecutive siblings trigger a hang bug in Windows (only). If this happens, add this style to mark the button as not belonging to a group, and implement the mutually-exclusive group behaviour yourself.
wxRB_USE_CHECKBOX Use a checkbox button instead of radio button (currently supported only on PalmOS).

See also window styles overview.

Event handling

EVT_RADIOBUTTON(id, func) Process a wxEVT_COMMAND_RADIOBUTTON_SELECTED event, when the radiobutton is clicked.

See also

Event handling overview, wxRadioBox, wxCheckBox



wxRadioButton::wxRadioButton



wxRadioButton(void)

Default constructor.



wxRadioButton(wxWindow* parent, wxWindowID id, const wxString& label, const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxDefaultSize, long style = 0, const wxValidator& validator = wxDefaultValidator, const wxString& name = ``radioButton")

Constructor, creating and showing a radio button.

Parameters

parent
Parent window. Must not be NULL.

id
Window identifier. A value of -1 indicates a default value.

label
Label for the radio button.

pos
Window position. If the position (-1, -1) is specified then a default position is chosen.

size
Window size. If the default size (-1, -1) is specified then a default size is chosen.

style
Window style. See wxRadioButton.

validator
Window validator.

name
Window name.

See also

wxRadioButton::Create, wxValidator



wxRadioButton::~wxRadioButton



void ~wxRadioButton(void)

Destructor, destroying the radio button item.



wxRadioButton::Create



bool Create(wxWindow* parent, wxWindowID id, const wxString& label, const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxDefaultSize, long style = 0, const wxValidator& validator = wxDefaultValidator, const wxString& name = ``radioButton")

Creates the choice for two-step construction. See wxRadioButton::wxRadioButton for further details.



wxRadioButton::GetValue

bool GetValue(void) const

Returns true if the radio button is depressed, false otherwise.



wxRadioButton::SetValue



void SetValue(const bool value)

Sets the radio button to selected or deselected status. This does not cause a wxEVT_COMMAND_RADIOBUTTON_SELECTED event to get emitted.

Parameters

value
true to select, false to deselect.

ymasuda 平成17年11月19日