X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/2b9048c56f0aa04b2adbb7813f9698abdda15184..0a95d3369e08206a43032472418693f7726591e5:/wxPython/src/_combobox.i diff --git a/wxPython/src/_combobox.i b/wxPython/src/_combobox.i index 835d2e2be0..d593ea6f12 100644 --- a/wxPython/src/_combobox.i +++ b/wxPython/src/_combobox.i @@ -21,6 +21,47 @@ MAKE_CONST_WXSTRING(ComboBoxNameStr); %newgroup; +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 permits a single selection only. Combobox items are +numbered from zero.", " + +Styles +------ + ================ =============================================== + wx.CB_SIMPLE Creates a combobox with a permanently + displayed list. Windows only. + + wx.CB_DROPDOWN Creates a combobox with a drop-down list. + + 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_SORT Sorts the entries in the list alphabetically. + ================ =============================================== + +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 @@ -31,43 +72,193 @@ public: %pythonAppend wxComboBox "self._setOORInfo(self)" %pythonAppend wxComboBox() "" - wxComboBox(wxWindow* parent, wxWindowID id, - const wxString& value = wxPyEmptyString, - const wxPoint& pos = wxDefaultPosition, - const wxSize& size = wxDefaultSize, - int choices=0, wxString* choices_array=NULL, - long style = 0, - const wxValidator& validator = wxDefaultValidator, - const wxString& name = wxPyComboBoxNameStr); - %name(PreComboBox)wxComboBox(); - - bool Create(wxWindow* parent, wxWindowID id, - const wxString& value = wxPyEmptyString, - const wxPoint& pos = wxDefaultPosition, - const wxSize& size = wxDefaultSize, - int choices=0, wxString* choices_array=NULL, - long style = 0, - const wxValidator& validator = wxDefaultValidator, - const wxString& name = wxPyComboBoxNameStr); - - - virtual wxString GetValue() const; - virtual void SetValue(const wxString& value); - - virtual void Copy(); - virtual void Cut(); - virtual void Paste(); - - virtual void SetInsertionPoint(long pos); - virtual long GetInsertionPoint() const; - virtual long GetLastPosition() const; - virtual void Replace(long from, long to, const wxString& value); - void SetSelection(int n); - %name(SetMark) virtual void SetSelection(long from, long to); - virtual void SetEditable(bool editable); - - virtual void SetInsertionPointEnd(); - virtual void Remove(long from, long to); + DocCtorAStr( + wxComboBox(wxWindow* parent, wxWindowID id=-1, + const wxString& value = wxPyEmptyString, + const wxPoint& pos = wxDefaultPosition, + const wxSize& size = wxDefaultSize, + const wxArrayString& choices = wxPyEmptyStringArray, + long style = 0, + const wxValidator& validator = wxDefaultValidator, + const wxString& name = wxPyComboBoxNameStr), + "__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.", "", + PreComboBox); + + + DocDeclAStr( + bool, Create(wxWindow *parent, wxWindowID id=-1, + const wxString& value = wxPyEmptyString, + const wxPoint& pos = wxDefaultPosition, + const wxSize& size = wxDefaultSize, + const wxArrayString& choices = wxPyEmptyStringArray, + long style = 0, + const wxValidator& validator = wxDefaultValidator, + const wxString& name = wxPyChoiceNameStr), + "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.", ""); + + DocDeclStr( + virtual void , SetValue(const wxString& value), + "", ""); + + + DocDeclStr( + virtual void , Copy(), + "Copies the selected text to the clipboard.", ""); + + DocDeclStr( + virtual void , Cut(), + "Copies the selected text to the clipboard and removes the selection.", ""); + + DocDeclStr( + virtual void , Paste(), + "Pastes text from the clipboard to the text field.", ""); + + + DocDeclStr( + virtual void , SetInsertionPoint(long pos), + "Sets the insertion point in the combobox text field.", ""); + + DocDeclStr( + virtual long , GetInsertionPoint() const, + "Returns the insertion point for the combobox's text field.", ""); + + DocDeclStr( + virtual long , GetLastPosition() const, + "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 +combobox text field.", ""); + + DocDeclStr( + void , SetSelection(int n), + "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 + + + 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.", ""); + + DocDeclStr( + virtual void , Remove(long from, long to), + "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`"); + }; //---------------------------------------------------------------------------