wxradiobox

a radio box item is used to select one of number of mutually exclusive choices. it is displayed as a vertical column or horizontal row of labelled buttons.

derived from

wxcontrolwithitems
wxcontrol
wxwindow
wxevthandler
wxobject

include files

window styles

wxra_specify_rows	the major dimension parameter refers to the maximum number of rows.
wxra_specify_cols	the major dimension parameter refers to the maximum number of columns.
wxra_use_checkbox	use of the checkbox controls instead of radio buttons (currently supported only on palmos)

wxradiobox::wxradiobox

wxradiobox()

default constructor.

wxradiobox(wxwindow* parent, wxwindowid id, const wxstring& label, const wxpoint& point = wxdefaultposition, const wxsize& size = wxdefaultsize, int n = 0, const wxstring choices[] = null, int majordimension = 0, long style = wxra_specify_cols, const wxvalidator& validator = wxdefaultvalidator, const wxstring& name = "radiobox")

wxradiobox(wxwindow* parent, wxwindowid id, const wxstring& label, const wxpoint& point, const wxsize& size, const wxarraystring& choices, int majordimension = 0, long style = wxra_specify_cols, const wxvalidator& validator = wxdefaultvalidator, const wxstring& name = "radiobox")

constructor, creating and showing a radiobox.

parameters

parent

parent window. must not be null.

window identifier. a value of -1 indicates a default value.

label

label for the static box surrounding the radio buttons.

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.

number of choices with which to initialize the radiobox.

choices

an array of choices with which to initialize the radiobox.

majordimension

specifies the maximum number of rows (if style contains wxra_specify_rows) or columns (if style contains wxra_specify_cols) for a two-dimensional radiobox.

style

wxradiobox

validator

window validator.

name

window name.

see also

wxradiobox::create, wxvalidator

wxpython note: the wxradiobox constructor in wxpython reduces the n and choices arguments are to a single argument, which is a list of strings.

wxperl note: in wxperl there is just an array reference in place of n and choices.

wxradiobox::~wxradiobox

~wxradiobox()

destructor, destroying the radiobox item.

wxradiobox::create

bool create(wxwindow* parent, wxwindowid id, const wxstring& label, const wxpoint& point = wxdefaultposition, const wxsize& size = wxdefaultsize, int n = 0, const wxstring choices[] = null, int majordimension = 0, long style = wxra_specify_cols, const wxvalidator& validator = wxdefaultvalidator, const wxstring& name = "radiobox")

bool create(wxwindow* parent, wxwindowid id, const wxstring& label, const wxpoint& point, const wxsize& size, const wxarraystring& choices, int majordimension = 0, long style = wxra_specify_cols, const wxvalidator& validator = wxdefaultvalidator, const wxstring& name = "radiobox")

creates the radiobox for two-step construction. see wxradiobox::wxradiobox for further details.

wxradiobox::enable

virtual bool enable(bool enable = true)

enables or disables the entire radiobox.

virtual bool enable(unsigned int n, bool enable = true)

enables or disables an individual button in the radiobox.

parameters

enable

true to enable, false to disable.

the zero-based button to enable or disable.

wxpython note: in place of a single overloaded method name, wxpython implements the following methods:

enable(flag)	enables or disables the entire radiobox.
enableitem(n, flag)	enables or disables an individual button in the radiobox.

see also

wxwindow::enable

wxradiobox::findstring

int findstring(const wxstring& string) const

finds a button matching the given string, returning the position if found, or -1 if not found.

parameters

string

the string to find.

wxradiobox::getcolumncount

unsigned int getcolumncount() const

returns the number of columns in the radiobox.

wxradiobox::getitemhelptext

wxstring getitemhelptext(unsigned int item) const

returns the helptext associated with the specified item if any or wxemptystring.

parameters

item

the zero-based item index.

see also

setitemhelptext

wxradiobox::getitemtooltip

wxtooltip * getitemtooltip(unsigned int item) const

returns the tooltip associated with the specified item if any or null.

see also

setitemtooltip,
wxwindow::gettooltip

wxradiobox::getitemfrompoint

int getitemfrompoint(const wxpoint pt) const

returns a radio box item under the point, a zero-based item index, or wxnot_found if no item is under the point.

point in client coordinates.

wxradiobox::getlabel

wxstring getlabel() const

returns the radiobox label.

parameters

the zero-based button index.

see also

wxradiobox::setlabel

wxpython note: in place of a single overloaded method name, wxpython implements the following methods:

getlabel()	returns the radiobox label.
getitemlabel(n)	returns the label for the given button.

wxradiobox::getrowcount

unsigned int getrowcount() const

returns the number of rows in the radiobox.

wxradiobox::getselection

int getselection() const

returns the zero-based position of the selected button.

wxradiobox::getstringselection

wxstring getstringselection() const

returns the selected string.

wxradiobox::getstring

wxstring getstring(unsigned int n) const

returns the label for the button at the given position.

parameters

the zero-based button position.

wxradiobox::isitemenabled

bool isitemenabled(unsigned int n) const

returns true if the item is enabled or false if it was disabled using enable(n, false).

platform note: currently only implemented in wxmsw, wxgtk and wxuniversal and always returns true in the other ports.

parameters

the zero-based button position.

wxradiobox::isitemshown

bool isitemshown(unsigned int n) const

returns true if the item is currently shown or false if it was hidden using show(n, false).

note that this function returns true for an item which hadn't been hidden even if the entire radiobox is not currently shown.

platform note: currently only implemented in wxmsw, wxgtk and wxuniversal and always returns true in the other ports.

parameters

the zero-based button position.

wxradiobox::setitemhelptext

void setitemhelptext(unsigned int item, const wxstring& helptext)

sets the helptext for an item. empty string erases any existing helptext.

parameters

item

the zero-based item index.

helptext

the help text to set for the item.

see also

getitemhelptext

wxradiobox::setlabel

void setlabel(const wxstring& label)

sets the radiobox label.

parameters

label

the label to set.

the zero-based button index.

wxpython note: in place of a single overloaded method name, wxpython implements the following methods:

setlabel(string)	sets the radiobox label.
setitemlabel(n, string)	sets a label for a radio button.

wxradiobox::setselection

void setselection(int n)

sets a button by passing the desired string position. this does not cause a wxevt_command_radiobox_selected event to get emitted.

parameters

the zero-based button position.

wxradiobox::setstringselection

void setstringselection(const wxstring& string)

sets the selection to a button by passing the desired string. this does not cause a wxevt_command_radiobox_selected event to get emitted.

parameters

string

the label of the button to select.

wxradiobox::setitemtooltip

void setitemtooltip(unsigned int item, const wxstring& text)

sets the tooltip text for the specified item in the radio group.

platform note: currently only implemented in wxmsw and wxgtk2 and does nothing in the other ports.

parameters

item

index of the item the tooltip will be shown for.

text

tooltip text for the item, the tooltip is removed if empty.

see also

getitemtooltip,
wxwindow::settooltip

wxradiobox::show

virtual bool show(const bool show = true)

shows or hides the entire radiobox.

virtual bool show(unsigned int item, const bool show = true)

shows or hides individual buttons.

parameters

show

true to show, false to hide.

item

the zero-based position of the button to show or hide.

return value

true if the box or item has been shown or hidden or false if nothing was done because it already was in the requested state.

see also

wxwindow::show

wxpython note: in place of a single overloaded method name, wxpython implements the following methods:

show(flag)	shows or hides the entire radiobox.
showitem(n, flag)	shows or hides individual buttons.