DocStr(wxChoice,
"A Choice control is used to select one of a list of strings.
Unlike a `wx.ListBox`, only the selection is visible until the
-user pulls down the menu of choices.
+user pulls down the menu of choices.", "
Events
------
");
+MustHaveApp(wxChoice);
+
class wxChoice : public wxControlWithItems
{
public:
%pythonAppend wxChoice "self._setOORInfo(self)"
%pythonAppend wxChoice() ""
- RefDoc(wxChoice, ""); // turn it off for the ctors
-
DocCtorAStr(
wxChoice(wxWindow *parent, wxWindowID id=-1,
const wxPoint& pos = wxDefaultPosition,
const wxValidator& validator = wxDefaultValidator,
const wxString& name = wxPyChoiceNameStr),
"__init__(Window parent, int id, Point pos=DefaultPosition, Size size=DefaultSize,
- List choices=[], long style=0, Validator validator=DefaultValidator,
+ List choices=EmptyList, long style=0, Validator validator=DefaultValidator,
String name=ChoiceNameStr) -> Choice",
- "Create and show a Choice control");
+ "Create and show a Choice control", "");
DocCtorStrName(
wxChoice(),
- "Precreate a Choice control for 2-phase creation.",
+ "Precreate a Choice control for 2-phase creation.", "",
PreChoice);
const wxValidator& validator = wxDefaultValidator,
const wxString& name = wxPyChoiceNameStr),
"Create(Window parent, int id, Point pos=DefaultPosition, Size size=DefaultSize,
- List choices=[], long style=0, Validator validator=DefaultValidator,
+ List choices=EmptyList, long style=0, Validator validator=DefaultValidator,
String name=ChoiceNameStr) -> bool",
- "Actually create the GUI Choice control for 2-phase creation");
-
-
-// // These are only meaningful on wxMotif...
-// int GetColumns();
-// void SetColumns(const int n = 1);
-
+ "Actually create the GUI Choice control for 2-phase creation", "");
DocDeclStr(
- void , SetSelection(const int n),
- "Select the n'th item (zero based) in the list.");
+ int , GetCurrentSelection() const,
+ "Unlike `GetSelection` which only returns the accepted selection value,
+i.e. the selection in the control once the user closes the dropdown
+list, this function returns the current selection. That is, while the
+dropdown list is shown, it returns the currently selected item in
+it. When it is not shown, its result is the same as for the other
+function.", "");
- DocDeclStr(
- bool , SetStringSelection(const wxString& string),
- "Select the item with the specifed string");
-
- DocDeclStr(
- void , SetString(int n, const wxString& string),
- "Set the label for the n'th item (zero based) in the list.");
-
-
- %pythoncode { Select = SetSelection }
static wxVisualAttributes
GetClassDefaultAttributes(wxWindowVariant variant = wxWINDOW_VARIANT_NORMAL);