X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/ae3c17b4013e80b99976c750c19fca47729517f6..9e9574fe45b176ee74bba8fad7574cf9906145d1:/interface/wx/radiobut.h?ds=sidebyside diff --git a/interface/wx/radiobut.h b/interface/wx/radiobut.h index dfce977c50..706f05c293 100644 --- a/interface/wx/radiobut.h +++ b/interface/wx/radiobut.h @@ -2,13 +2,11 @@ // Name: radiobut.h // Purpose: interface of wxRadioButton // Author: wxWidgets team -// RCS-ID: $Id$ -// Licence: wxWindows license +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// /** @class wxRadioButton - @wxheader{radiobut.h} 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 @@ -26,27 +24,23 @@ 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 + Process a @c wxEVT_RADIOBUTTON event, when the radiobutton is clicked. @endEventTable @library{wxcore} @category{ctrl} - + @appearance{radiobutton} - @see @ref overview_eventhandling, wxRadioBox, wxCheckBox + @see @ref overview_events, wxRadioBox, wxCheckBox */ class wxRadioButton : public wxControl { public: - /** Default constructor. @@ -64,11 +58,11 @@ public: @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 @@ -84,37 +78,40 @@ public: 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. + Returns @true if the radio button is checked, @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. + Sets the radio button to checked or unchecked status. This does not cause a + @c wxEVT_RADIOBUTTON 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. */ - void SetValue(const bool value); + virtual void SetValue(bool value); };