X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/adaaa68635b4c8a4d8c5284add40366ea3eefb07..1b7751aaa9a86d76a850b9267bc0c201e3cea30f:/interface/wx/radiobox.h diff --git a/interface/wx/radiobox.h b/interface/wx/radiobox.h index e75165e4c1..be54439d7f 100644 --- a/interface/wx/radiobox.h +++ b/interface/wx/radiobox.h @@ -3,7 +3,7 @@ // Purpose: interface of wxRadioBox // Author: wxWidgets team // RCS-ID: $Id$ -// Licence: wxWindows license +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// /** @@ -19,22 +19,19 @@ @style{wxRA_SPECIFY_COLS} The major dimension parameter refers to the maximum number of columns. - @style{wxRA_USE_CHECKBOX} - Use of the checkbox controls instead of radio buttons (currently - supported only on PalmOS) @endStyleTable - @beginEventTable{wxCommandEvent} + @beginEventEmissionTable{wxCommandEvent} @event{EVT_RADIOBOX(id, func)} - Process a @c wxEVT_COMMAND_RADIOBOX_SELECTED event, when a radiobutton + Process a @c wxEVT_RADIOBOX event, when a radiobutton is clicked. @endEventTable @library{wxcore} @category{ctrl} - + @appearance{radiobox} - @see @ref overview_eventhandling, wxRadioButton, wxCheckBox + @see @ref overview_events, wxRadioButton, wxCheckBox */ class wxRadioBox : public wxControl, wxItemContainerImmutable { @@ -57,10 +54,10 @@ public: @param label Label for the static box surrounding the radio buttons. @param pos - Window position. If @c wxDefaultPosition is specified then a + 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 + Window size. If ::wxDefaultSize is specified then a default size is chosen. @param n Number of choices with which to initialize the radiobox. @@ -69,7 +66,8 @@ public: @param majorDimension Specifies the maximum number of rows (if style contains @c wxRA_SPECIFY_ROWS) or columns (if style contains - @c wxRA_SPECIFY_COLS) for a two-dimensional radiobox. + @c wxRA_SPECIFY_COLS) for a two-dimensional radiobox. The default + value of 0 means to use the number of items, i.e. @a n. @param style Window style. See wxRadioBox. @param validator @@ -77,6 +75,10 @@ public: @param name Window name. + @beginWxPerlOnly + Not supported by wxPerl. + @endWxPerlOnly + @see Create(), wxValidator */ wxRadioBox(wxWindow* parent, wxWindowID id, @@ -88,7 +90,7 @@ public: int majorDimension = 0, long style = wxRA_SPECIFY_COLS, const wxValidator& validator = wxDefaultValidator, - const wxString& name = "radioBox"); + const wxString& name = wxRadioBoxNameStr); /** Constructor, creating and showing a radiobox. @@ -100,17 +102,19 @@ public: @param label Label for the static box surrounding the radio buttons. @param pos - Window position. If @c wxDefaultPosition is specified then a + 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 + Window size. If ::wxDefaultSize is specified then a default size is chosen. @param choices An array of choices with which to initialize the radiobox. @param majorDimension Specifies the maximum number of rows (if style contains @c wxRA_SPECIFY_ROWS) or columns (if style contains - @c wxRA_SPECIFY_COLS) for a two-dimensional radiobox. + @c wxRA_SPECIFY_COLS) for a two-dimensional radiobox. The default + value of 0 means to use the number of items, i.e. number of + elements in @a choices. @param style Window style. See wxRadioBox. @param validator @@ -118,6 +122,10 @@ public: @param name Window name. + @beginWxPerlOnly + Use an array reference for the @a choices parameter. + @endWxPerlOnly + @see Create(), wxValidator */ wxRadioBox(wxWindow* parent, wxWindowID id, @@ -128,7 +136,7 @@ public: int majorDimension = 0, long style = wxRA_SPECIFY_COLS, const wxValidator& validator = wxDefaultValidator, - const wxString& name = "radioBox"); + const wxString& name = wxRadioBoxNameStr); /** Destructor, destroying the radiobox item. @@ -148,7 +156,7 @@ public: int majorDimension = 0, long style = wxRA_SPECIFY_COLS, const wxValidator& validator = wxDefaultValidator, - const wxString& name = "radioBox"); + const wxString& name = wxRadioBoxNameStr); /** Creates the radiobox for two-step construction. See wxRadioBox() @@ -162,7 +170,7 @@ public: int majorDimension = 0, long style = wxRA_SPECIFY_COLS, const wxValidator& validator = wxDefaultValidator, - const wxString& name = "radioBox"); + const wxString& name = wxRadioBoxNameStr); /** Enables or disables an individual button in the radiobox. @@ -174,27 +182,19 @@ public: @see wxWindow::Enable() - @beginWxPythonOnly - In place of a single overloaded method name, wxPython implements the following methods: - - @beginTable - @row2col{Enable(flag), Enables or disables the entire radiobox.} - @row2col{EnableItem(n\, flag), Enables or disables an individual button in the radiobox.} - @endTable - - @endWxPythonOnly */ virtual bool Enable(unsigned int n, bool enable = true); - /** - Finds a button matching the given string, returning the position if found, or - -1 if not found. + Finds a button matching the given string, returning the position if found, + or @c wxNOT_FOUND if not found. @param string The string to find. + @param bCase + Should the search be case-sensitive? */ - int FindString(const wxString& string) const; + virtual int FindString(const wxString& string, bool bCase = false) const; /** Returns the number of columns in the radiobox. @@ -208,7 +208,7 @@ public: @param pt Point in client coordinates. */ - int GetItemFromPoint(const wxPoint pt) const; + virtual int GetItemFromPoint(const wxPoint& pt) const; /** Returns the helptext associated with the specified @a item if any or @c @@ -287,6 +287,14 @@ public: */ void SetItemToolTip(unsigned int item, const wxString& text); + /** + Sets the selection to the given item. + + Notice that a radio box always has selection, so @a n must be valid + here and passing @c wxNOT_FOUND is not allowed. + */ + virtual void SetSelection(int n); + /** Shows or hides individual buttons. @@ -302,16 +310,14 @@ public: @see wxWindow::Show() - @beginWxPythonOnly - In place of a single overloaded method name, wxPython implements the following methods: + */ + virtual bool Show(unsigned int item, bool show = true); - @beginTable - @row2col{Show(flag), Shows or hides the entire radiobox.} - @row2col{ShowItem(n\, flag), Shows or hides individual buttons.} - @endTable - @endWxPythonOnly + // pure virtuals that have implementations here + virtual unsigned int GetCount() const; + virtual wxString GetString(unsigned int n) const; + virtual void SetString(unsigned int n, const wxString& string); + virtual int GetSelection() const; - */ - virtual bool Show(unsigned int item, const bool show = true); };