DocStr(wxComboBox,
-"A combobox is like a combination of an edit control and a listbox. It can be
-displayed as static list with editable or read-only text field; or a drop-down
-list with text field.");
+"A combobox is like a combination of an edit control and a
+listbox. It can be displayed as static list with editable or
+read-only text field; or a drop-down list with text field.
-RefDoc(wxComboBox, "
- Styles
- wx.CB_SIMPLE: Creates a combobox with a permanently displayed list.
- Windows only.
+A combobox permits a single selection only. Combobox items are
+numbered from zero.", "
- wx.CB_DROPDOWN: Creates a combobox with a drop-down list.
+Styles
+------
+ ================ ===============================================
+ wx.CB_SIMPLE Creates a combobox with a permanently
+ displayed list. Windows only.
- wx.CB_READONLY: Same as wxCB_DROPDOWN but only the strings specified as
- the combobox choices can be selected, it is impossible
- to select (even from a program) a string which is not in
- the choices list.
+ wx.CB_DROPDOWN Creates a combobox with a drop-down list.
- wx.CB_SORT: Sorts the entries in the list alphabetically.
+ wx.CB_READONLY Same as wxCB_DROPDOWN but only the strings
+ specified as the combobox choices can be
+ selected, it is impossible to select
+ (even from a program) a string which is
+ not in the choices list.
- Events
+ wx.CB_SORT Sorts the entries in the list alphabetically.
+ ================ ===============================================
- EVT_COMBOBOX: Sent when an item on the list is selected.
- EVT_TEXT: Sent when the combobox text changes.
+Events
+-------
+ ================ ===============================================
+ EVT_COMBOBOX Sent when an item on the list is selected.
+ Note that calling `GetValue` in this handler
+ will return the newly selected value.
+ EVT_TEXT Sent when the combobox text changes.
+ EVT_TEXT_ENTER Sent when the RETURN/ENTER key is pressed in
+ the combobox.
+ ================ ===============================================
");
+MustHaveApp(wxComboBox);
+
#ifdef __WXMSW__
class wxComboBox : public wxChoice
#else
%pythonAppend wxComboBox "self._setOORInfo(self)"
%pythonAppend wxComboBox() ""
- RefDoc(wxComboBox, ""); // turn it off for the ctors
-
DocCtorAStr(
- wxComboBox(wxWindow* parent, wxWindowID id,
+ wxComboBox(wxWindow* parent, wxWindowID id=-1,
const wxString& value = wxPyEmptyString,
const wxPoint& pos = wxDefaultPosition,
const wxSize& size = wxDefaultSize,
long style = 0,
const wxValidator& validator = wxDefaultValidator,
const wxString& name = wxPyComboBoxNameStr),
- "__init__(Window parent, int id, String value=EmptyString,\n"
- " Point pos=DefaultPosition, Size size=DefaultSize,\n"
- " List choices=[], long style=0, Validator validator=DefaultValidator,\n"
- " String name=ComboBoxNameStr) -> ComboBox",
- "Constructor, creates and shows a ComboBox control.");
+ "__init__(Window parent, int id, String value=EmptyString,
+ Point pos=DefaultPosition, Size size=DefaultSize,
+ List choices=EmptyList, long style=0, Validator validator=DefaultValidator,
+ String name=ComboBoxNameStr) -> ComboBox",
+ "Constructor, creates and shows a ComboBox control.", "");
DocCtorStrName(
wxComboBox(),
- "Precreate a ComboBox control for 2-phase creation.",
+ "Precreate a ComboBox control for 2-phase creation.", "",
PreComboBox);
DocDeclAStr(
- bool, Create(wxWindow *parent, wxWindowID id,
+ bool, Create(wxWindow *parent, wxWindowID id=-1,
const wxString& value = wxPyEmptyString,
const wxPoint& pos = wxDefaultPosition,
const wxSize& size = wxDefaultSize,
long style = 0,
const wxValidator& validator = wxDefaultValidator,
const wxString& name = wxPyChoiceNameStr),
- "Create(Window parent, int id, String value=EmptyString,\n"
- " Point pos=DefaultPosition, Size size=DefaultSize,\n"
- " List choices=[], long style=0, Validator validator=DefaultValidator,\n"
- " String name=ChoiceNameStr) -> bool",
- "Actually create the GUI wxComboBox control for 2-phase creation");
+ "Create(Window parent, int id, String value=EmptyString,
+ Point pos=DefaultPosition, Size size=DefaultSize,
+ List choices=EmptyList, long style=0, Validator validator=DefaultValidator,
+ String name=ChoiceNameStr) -> bool",
+ "Actually create the GUI wxComboBox control for 2-phase creation", "");
DocDeclStr(
virtual wxString , GetValue() const,
- "Returns the current value in the combobox text field.");
+ "Returns the current value in the combobox text field.", "");
DocDeclStr(
virtual void , SetValue(const wxString& value),
- "");
+ "", "");
DocDeclStr(
virtual void , Copy(),
- "Copies the selected text to the clipboard.");
+ "Copies the selected text to the clipboard.", "");
DocDeclStr(
virtual void , Cut(),
- "Copies the selected text to the clipboard and removes the selection.");
+ "Copies the selected text to the clipboard and removes the selection.", "");
DocDeclStr(
virtual void , Paste(),
- "Pastes text from the clipboard to the text field.");
+ "Pastes text from the clipboard to the text field.", "");
DocDeclStr(
virtual void , SetInsertionPoint(long pos),
- "Sets the insertion point in the combobox text field.");
+ "Sets the insertion point in the combobox text field.", "");
DocDeclStr(
virtual long , GetInsertionPoint() const,
- "Returns the insertion point for the combobox's text field.");
+ "Returns the insertion point for the combobox's text field.", "");
DocDeclStr(
virtual long , GetLastPosition() const,
- "Returns the last position in the combobox text field.");
+ "Returns the last position in the combobox text field.", "");
DocDeclStr(
virtual void , Replace(long from, long to, const wxString& value),
- "Replaces the text between two positions with the given text, in the\n"
- "combobox text field.");
+ "Replaces the text between two positions with the given text, in the
+combobox text field.", "");
DocDeclStr(
void , SetSelection(int n),
- "Selects the text between the two positions, in the combobox text field.");
+ "Sets the item at index 'n' to be the selected item.", "");
+
+ DocDeclStrName(
+ virtual void , SetSelection(long from, long to),
+ "Selects the text between the two positions in the combobox text field.", "",
+ SetMark);
+
+#ifndef __WXMAC__
+ DocDeclAStrName(
+ virtual void , GetSelection(long* OUTPUT, long* OUTPUT),
+ "GetMark(self) -> (from, to)",
+ "Gets the positions of the begining and ending of the selection mark in
+the combobox text field.", "",
+ GetMark);
+#else
+ %pythoncode {
+ def GetMark(self):
+ return (0,0)
+ }
+#endif
- %name(SetMark) virtual void SetSelection(long from, long to);
+ DocDeclStr(
+ 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.", "");
+
DocDeclStr(
virtual void , SetEditable(bool editable),
- "");
+ "", "");
DocDeclStr(
virtual void , SetInsertionPointEnd(),
- "Sets the insertion point at the end of the combobox text field.");
+ "Sets the insertion point at the end of the combobox text field.", "");
DocDeclStr(
virtual void , Remove(long from, long to),
- "Removes the text between the two positions in the combobox text field.");
+ "Removes the text between the two positions in the combobox text field.", "");
+
+
+
+ DocDeclStr(
+ bool , IsEditable() const,
+ "Returns True if the combo is ediatable (not read-only.)", "");
+
+
+ DocDeclStr(
+ void , Undo(),
+ "Redoes the last undo in the text field. Windows only.", "");
+ DocDeclStr(
+ void , Redo(),
+ "Undoes the last edit in the text field. Windows only.", "");
+
+ DocDeclStr(
+ void , SelectAll(),
+ "Select all the text in the combo's text field.", "");
+
+
+ DocDeclStr(
+ bool , CanCopy() const,
+ "Returns True if the combobox is editable and there is a text selection
+to copy to the clipboard. Only available on Windows.", "");
+
+ DocDeclStr(
+ bool , CanCut() const,
+ "Returns True if the combobox is editable and there is a text selection
+to copy to the clipboard. Only available on Windows.", "");
+
+ DocDeclStr(
+ bool , CanPaste() const,
+ "Returns True if the combobox is editable and there is text on the
+clipboard that can be pasted into the text field. Only available on
+Windows.", "");
+
+ DocDeclStr(
+ bool , CanUndo() const,
+ "Returns True if the combobox is editable and the last edit can be
+undone. Only available on Windows.", "");
+
+ DocDeclStr(
+ bool , CanRedo() const,
+ "Returns True if the combobox is editable and the last undo can be
+redone. Only available on Windows.", "");
+
+
+
+ static wxVisualAttributes
+ GetClassDefaultAttributes(wxWindowVariant variant = wxWINDOW_VARIANT_NORMAL);
+
+ %property(CurrentSelection, GetCurrentSelection, doc="See `GetCurrentSelection`");
+ %property(InsertionPoint, GetInsertionPoint, SetInsertionPoint, doc="See `GetInsertionPoint` and `SetInsertionPoint`");
+ %property(LastPosition, GetLastPosition, doc="See `GetLastPosition`");
+ %property(Mark, GetMark, SetMark, doc="See `GetMark` and `SetMark`");
+ %property(Value, GetValue, SetValue, doc="See `GetValue` and `SetValue`");
+
};
//---------------------------------------------------------------------------
projects / wxWidgets.git / blobdiff