// Purpose: interface of wxRadioButton
// Author: wxWidgets team
// RCS-ID: $Id$
-// Licence: wxWindows license
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
/**
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.
@library{wxcore}
@category{ctrl}
- <!-- @appearance{radiobutton.png} -->
+ @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 wxSize& size = wxDefaultSize,
long style = 0,
const wxValidator& validator = wxDefaultValidator,
- const wxString& name = "radioButton");
+ const wxString& name = wxRadioButtonNameStr);
/**
Destructor, destroying the radio button item.
*/
- ~wxRadioButton();
+ virtual ~wxRadioButton();
/**
Creates the choice for two-step construction. See wxRadioButton() for
further details.
*/
- bool Create(wxWindow* parent, wxWindowID id,
- const wxString& label,
+ bool Create(wxWindow* parent, wxWindowID id, const wxString& label,
const wxPoint& pos = wxDefaultPosition,
- const wxSize& size = wxDefaultSize,
- long style = 0,
+ const wxSize& size = wxDefaultSize, long style = 0,
const wxValidator& validator = wxDefaultValidator,
- const wxString& name = "radioButton");
+ const wxString& name = wxRadioButtonNameStr);
/**
Returns @true if the radio button is depressed, @false otherwise.
*/
- bool GetValue() const;
+ virtual bool GetValue() const;
/**
Sets the radio button to selected or deselected status. This does not cause a
@c wxEVT_COMMAND_RADIOBUTTON_SELECTED event to get emitted.
+
+ If the radio button belongs to a group you can only select a radio button
+ (which will deselect the previously selected button) and you therefore
+ must not call this method with value set to @false in that case.
@param value
@true to select, @false to deselect.
*/
- void SetValue(const bool value);
+ virtual void SetValue(bool value);
};