// Purpose: interface of wxRadioButton
// Author: wxWidgets team
// RCS-ID: $Id$
-// Licence: wxWindows license
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
/**
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.
- @style{wxRB_USE_CHECKBOX}
- Use a checkbox button instead of radio button (currently supported
- only on PalmOS).
@endStyleTable
- @beginEventTable{wxCommandEvent}
+ @beginEventEmissionTable{wxCommandEvent}
@event{EVT_RADIOBUTTON(id, func)}
Process a @c wxEVT_COMMAND_RADIOBUTTON_SELECTED event, when the
radiobutton is clicked.
@category{ctrl}
@appearance{radiobutton.png}
- @see @ref overview_eventhandling, wxRadioBox, wxCheckBox
+ @see @ref overview_events, wxRadioBox, wxCheckBox
*/
class wxRadioButton : public wxControl
{
public:
-
/**
Default constructor.
@param label
Label for the radio button.
@param pos
- Window position. If @c wxDefaultPosition is specified then a default
- position is chosen.
+ Window position. If ::wxDefaultPosition is specified then a default
+ position is chosen.
@param size
- Window size. If @c wxDefaultSize is specified then a default size
- is chosen.
+ Window size. If ::wxDefaultSize is specified then a default size
+ is chosen.
@param style
Window style. See wxRadioButton.
@param validator
const wxString& name = wxRadioButtonNameStr);
/**
- Returns @true if the radio button is depressed, @false otherwise.
+ Returns @true if the radio button is checked, @false otherwise.
*/
virtual bool GetValue() const;
/**
- Sets the radio button to selected or deselected status. This does not cause a
+ Sets the radio button to checked or unchecked status. This does not cause a
@c wxEVT_COMMAND_RADIOBUTTON_SELECTED event to get emitted.
+ If the radio button belongs to a radio group exactly one button in the
+ group may be checked and so this method can be only called with @a
+ value set to @true. To uncheck a radio button in a group you must check
+ another button in the same group.
+
@param value
- @true to select, @false to deselect.
+ @true to check, @false to uncheck.
*/
virtual void SetValue(bool value);
};