wxmultichoicedialog

this class represents a dialog that shows a list of strings, and allows the user to select one or more.

derived from

wxdialog
wxwindow
wxevthandler
wxobject

include files

<wx/choicdlg.h>

see also

wxmultichoicedialog overview, wxsinglechoicedialog

members

wxmultichoicedialog::wxmultichoicedialog
wxmultichoicedialog::getselections
wxmultichoicedialog::setselections
wxmultichoicedialog::showmodal

wxmultichoicedialog::wxmultichoicedialog

wxmultichoicedialog(wxwindow* parent, const wxstring& message, const wxstring& caption, int n, const wxstring* choices, long style = wxchoicedlg_style, const wxpoint& pos = wxdefaultposition)

wxmultichoicedialog(wxwindow* parent, const wxstring& message, const wxstring& caption, const wxarraystring& choices, long style = wxchoicedlg_style, const wxpoint& pos = wxdefaultposition)

constructor taking an array of wxstring choices.

parameters

parent

parent window.

message

message to show on the dialog.

caption

the dialog caption.

n

the number of choices.

choices

an array of strings, or a string list, containing the choices.

style

a dialog style (bitlist) containing flags chosen from standard dialog styles and the following:

wxok	show an ok button.
wxcancel	show a cancel button.
wxcentre	centre the message. not windows.

the default value is equivalent to wxdefault_dialog_style | wxresize_border | wxok | wxcancel | wxcentre.

pos

dialog position. not windows.

remarks

use wxmultichoicedialog::showmodal to show the dialog.

wxpython note: for python the two parameters n and choices are collapsed into a multi parameter choices which is expected to be a python list of strings.

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

wxmultichoicedialog::getselections

wxarrayint getselection() const

returns array with indexes of selected items.

wxmultichoicedialog::setselections

void setselections(const wxarrayint& selections) const

sets selected items from the array of selected items' indexes.

wxmultichoicedialog::showmodal

int showmodal()

shows the dialog, returning either wxid_ok or wxid_cancel.