X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/014577f34095b9a63a9ec809aa73c7b90be11ca7..015fd9ef4833ec3d8b0043a1c7e448c8be4f734a:/wxPython/src/_combobox.i diff --git a/wxPython/src/_combobox.i b/wxPython/src/_combobox.i index d4b4bfa966..079591dd81 100644 --- a/wxPython/src/_combobox.i +++ b/wxPython/src/_combobox.i @@ -22,32 +22,42 @@ MAKE_CONST_WXSTRING(ComboBoxNameStr); 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."); - -RefDoc(wxComboBox, " - 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. - EVT_TEXT: Sent when the combobox text changes. +"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. + EVT_TEXT Sent when the combobox text changes. + ================ =============================================== "); +MustHaveApp(wxComboBox); + #ifdef __WXMSW__ class wxComboBox : public wxChoice #else @@ -59,7 +69,7 @@ public: %pythonAppend wxComboBox() "" DocCtorAStr( - wxComboBox(wxWindow* parent, wxWindowID id, + wxComboBox(wxWindow* parent, wxWindowID id=-1, const wxString& value = wxPyEmptyString, const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxDefaultSize, @@ -67,20 +77,20 @@ public: 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=[], 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, @@ -88,71 +98,84 @@ public: 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=[], 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.", ""); - %name(SetMark) virtual void SetSelection(long from, long to); + DocDeclStrName( + virtual void , SetSelection(long from, long to), + "Selects the text between the two positions in the combobox text field.", "", + SetMark); + 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.", ""); + static wxVisualAttributes + GetClassDefaultAttributes(wxWindowVariant variant = wxWINDOW_VARIANT_NORMAL); }; //---------------------------------------------------------------------------