X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/174051f6139a05e5bc5a2ba101534a4742e3afb1..96285a18aa6f39e754ae562cc427f005a3402f43:/wxPython/src/_control.i diff --git a/wxPython/src/_control.i b/wxPython/src/_control.i index 6e7e46de39..94b33f048a 100644 --- a/wxPython/src/_control.i +++ b/wxPython/src/_control.i @@ -24,58 +24,88 @@ MAKE_CONST_WXSTRING(ControlNameStr); DocStr(wxControl, "This is the base class for a control or 'widget'. -A control is generally a small window which processes user input and/or -displays one or more item of data."); +A control is generally a small window which processes user input +and/or displays one or more item of data.", ""); + +MustHaveApp(wxControl); class wxControl : public wxWindow { public: %pythonAppend wxControl "self._setOORInfo(self)" %pythonAppend wxControl() "" + %typemap(out) wxControl*; // turn off this typemap DocCtorStr( wxControl(wxWindow *parent, - wxWindowID id, - const wxPoint& pos=wxDefaultPosition, - const wxSize& size=wxDefaultSize, - long style=0, - const wxValidator& validator=wxDefaultValidator, + wxWindowID id=-1, + const wxPoint& pos=wxDefaultPosition, + const wxSize& size=wxDefaultSize, + long style=0, + const wxValidator& validator=wxDefaultValidator, const wxString& name=wxPyControlNameStr), - "Create a Control. Normally you should only call this from a\n" - "subclass' __init__ as a plain old wx.Control is not very useful."); + "Create a Control. Normally you should only call this from a subclass' +__init__ as a plain old wx.Control is not very useful.", ""); DocCtorStrName( wxControl(), - "Precreate a Control control for 2-phase creation", + "Precreate a Control control for 2-phase creation", "", PreControl); + // Turn it back on again + %typemap(out) wxControl* { $result = wxPyMake_wxObject($1, $owner); } + + DocDeclStr( bool , Create(wxWindow *parent, - wxWindowID id, + wxWindowID id=-1, const wxPoint& pos=wxDefaultPosition, const wxSize& size=wxDefaultSize, long style=0, const wxValidator& validator=wxDefaultValidator, const wxString& name=wxPyControlNameStr), - "Do the 2nd phase and create the GUI control."); + "Do the 2nd phase and create the GUI control.", ""); DocDeclStr( - void , Command(wxCommandEvent& event), - "Simulates the effect of the user issuing a command to the\n" - "item. See wx.CommandEvent."); - + int , GetAlignment() const, + "Get the control alignment (left/right/centre, top/bottom/centre)", ""); + + DocDeclStr( - wxString , GetLabel(), - "Return a control's text."); + wxString , GetLabelText() const, + "Get just the text of the label, without mnemonic characters ('&')", ""); + + DocDeclStr( - void , SetLabel(const wxString& label), - "Sets the item's text."); + void , Command(wxCommandEvent& event), + "Simulates the effect of the user issuing a command to the item. + +:see: `wx.CommandEvent` +", ""); + +// DocDeclStr( +// bool , GetAdjustMinSizeFlag(), +// "Returns whether the minsize should be adjusted for this control when +// `SetLabel` or `SetFont` are called.", ""); + +// DocDeclStr( +// void , SetAdjustMinSizeFlag(bool adjust), +// "By default controls will readjust their size and minsize when +// `SetLabel` or `SetFont` are called. This flag will allow you to +// control this behavior.", " + +// :see: `GetAdjustMinSizeFlag` +// "); static wxVisualAttributes GetClassDefaultAttributes(wxWindowVariant variant = wxWINDOW_VARIANT_NORMAL); + + %property(Alignment, GetAlignment, doc="See `GetAlignment`"); + %property(LabelText, GetLabelText, doc="See `GetLabelText`"); + }; @@ -83,33 +113,35 @@ public: %newgroup; + + DocStr(wxItemContainer, -"wx.ItemContainer defines an interface which is implemented by all -controls which have string subitems, each of which may be -selected, such as wx.ListBox, wx.CheckListBox, wx.Choice and -wx.ComboBox (which implements an extended interface deriving from -this one) +"The wx.ItemContainer class defines an interface which is implemented +by all controls which have string subitems, each of which may be +selected, such as `wx.ListBox`, `wx.CheckListBox`, `wx.Choice` as well +as `wx.ComboBox` which implements an extended interface deriving from +this one. -It defines the methods for accessing the control's items and -although each of the derived classes implements them differently, -they still all conform to the same interface. +It defines the methods for accessing the control's items and although +each of the derived classes implements them differently, they still +all conform to the same interface. -The items in a wx.ItemContainer have (non empty) string labels -and, optionally, client data associated with them. -"); +The items in a wx.ItemContainer have (non empty) string labels and, +optionally, client data associated with them. +", ""); class wxItemContainer { public: - // wxItemContainer() { m_clientDataItemsType = wxClientData_None; } ** It's an ABC + // wxItemContainer() ** It's an ABC %extend { DocStr(Append, - "Adds the item to the control, associating the given data with the\n" - "item if not None. The return value is the index of the newly\n" - "added item which may be different from the last one if the\n" - "control is sorted (e.g. has wx.LB_SORT or wx.CB_SORT style)."); + "Adds the item to the control, associating the given data with the item +if not None. The return value is the index of the newly added item +which may be different from the last one if the control is sorted (e.g. +has wx.LB_SORT or wx.CB_SORT style).", ""); int Append(const wxString& item, PyObject* clientData=NULL) { if (clientData) { wxPyClientData* data = new wxPyClientData(clientData); @@ -119,19 +151,20 @@ public: } } - DocDeclStrName( + DocDeclAStrName( void , Append(const wxArrayString& strings), - "Apend several items at once to the control. Notice that calling\n" - "this method may be much faster than appending the items one by\n" - "one if you need to add a lot of items.", + "AppendItems(self, List strings)", + "Apend several items at once to the control. Notice that calling this +method may be much faster than appending the items one by one if you +need to add a lot of items.", "", AppendItems); %extend { DocStr(Insert, - "Insert an item into the control before the item at the pos index,\n" - "optionally associating some data object with the item."); - int Insert(const wxString& item, int pos, PyObject* clientData=NULL) { + "Insert an item into the control before the item at the ``pos`` index, +optionally associating some data object with the item.", ""); + int Insert(const wxString& item, unsigned int pos, PyObject* clientData=NULL) { if (clientData) { wxPyClientData* data = new wxPyClientData(clientData); return self->Insert(item, pos, data); @@ -143,84 +176,111 @@ public: DocDeclStr( virtual void , Clear(), - "Removes all items from the control."); + "Removes all items from the control.", ""); DocDeclStr( - virtual void , Delete(int n), - "Deletes the item at the zero-based index 'n' from the control.\n" - "Note that it is an error (signalled by a PyAssertionError\n" - "exception if enabled) to remove an item with the index negative\n" - "or greater or equal than the number of items in the control."); + virtual void , Delete(unsigned int n), + "Deletes the item at the zero-based index 'n' from the control. Note +that it is an error (signalled by a `wx.PyAssertionError` exception if +enabled) to remove an item with the index negative or greater or equal +than the number of items in the control.", ""); + + + + %extend { + DocStr(GetClientData, + "Returns the client data associated with the given item, (if any.)", ""); + PyObject* GetClientData(unsigned int n) { + wxPyClientData* data = (wxPyClientData*)self->GetClientObject(n); + if (data) { + Py_INCREF(data->m_obj); + return data->m_obj; + } else { + Py_INCREF(Py_None); + return Py_None; + } + } + + DocStr(SetClientData, + "Associate the given client data with the item at position n.", ""); + void SetClientData(unsigned int n, PyObject* clientData) { + wxPyClientData* data = new wxPyClientData(clientData); + self->SetClientObject(n, data); + } + } + DocDeclStr( - virtual int , GetCount() const, - "Returns the number of items in the control."); + virtual unsigned int , GetCount() const, + "Returns the number of items in the control.", ""); DocDeclStr( bool , IsEmpty() const, - "Returns True if the control is empty or False if it has some items."); + "Returns True if the control is empty or False if it has some items.", ""); DocDeclStr( - virtual wxString , GetString(int n) const, - "Returns the label of the item with the given index."); + virtual wxString , GetString(unsigned int n) const, + "Returns the label of the item with the given index.", ""); DocDeclStr( wxArrayString , GetStrings() const, - ""); + "", ""); DocDeclStr( - virtual void , SetString(int n, const wxString& s), - "Sets the label for the given item."); + virtual void , SetString(unsigned int n, const wxString& s), + "Sets the label for the given item.", ""); DocDeclStr( virtual int , FindString(const wxString& s) const, - "Finds an item whose label matches the given string. Returns the\n" - "zero-based position of the item, or wx.NOT_FOUND if the string\n" - "was not found."); + "Finds an item whose label matches the given string. Returns the +zero-based position of the item, or ``wx.NOT_FOUND`` if the string was not +found.", ""); - DocDeclStr( - virtual void , Select(int n), - "Sets the item at index 'n' to be the selected item."); - - %pythoncode { SetSelection = Select } + virtual void , SetSelection(int n), + "Sets the item at index 'n' to be the selected item.", ""); DocDeclStr( virtual int , GetSelection() const, - "Returns the index of the selected item or wx.NOT_FOUND if no item is selected."); + "Returns the index of the selected item or ``wx.NOT_FOUND`` if no item +is selected.", ""); + bool SetStringSelection(const wxString& s); + DocDeclStr( wxString , GetStringSelection() const, - "Returns the label of the selected item or an empty string if no item is selected."); + "Returns the label of the selected item or an empty string if no item +is selected.", ""); + DocDeclStr( + void , Select(int n), + "This is the same as `SetSelection` and exists only because it is +slightly more natural for controls which support multiple selection.", ""); + - %extend { - DocStr(GetClientData, - "Returns the client data associated with the given item, (if any.)"); - PyObject* GetClientData(int n) { - wxPyClientData* data = (wxPyClientData*)self->GetClientObject(n); - if (data) { - Py_INCREF(data->m_obj); - return data->m_obj; - } else { - Py_INCREF(Py_None); - return Py_None; - } - } - - DocStr(SetClientData, - "Associate the given client data with the item at position n."); - void SetClientData(int n, PyObject* clientData) { - wxPyClientData* data = new wxPyClientData(clientData); - self->SetClientObject(n, data); - } + %pythoncode { + def GetItems(self): + """Return a list of the strings in the control""" + return [self.GetString(i) for i in xrange(self.GetCount())] + + def SetItems(self, items): + """Clear and set the strings in the control from a list""" + self.Clear() + for i in items: + self.Append(i) } - + + %property(Count, GetCount, doc="See `GetCount`"); + %property(Items, GetItems, SetItems, doc="See `GetItems` and `SetItems`"); + %property(Selection, GetSelection, SetSelection, doc="See `GetSelection` and `SetSelection`"); + %property(StringSelection, GetStringSelection, SetStringSelection, doc="See `GetStringSelection` and `SetStringSelection`"); + %property(Strings, GetStrings, doc="See `GetStrings`"); + }; @@ -228,9 +288,9 @@ public: %newgroup; DocStr(wxControlWithItems, -"wx.ControlWithItems combines the wx.ItemContainer class with the -wx.Control class, and is used for the base class of various -controls that have items."); +"wx.ControlWithItems combines the ``wx.ItemContainer`` class with the +wx.Control class, and is used for the base class of various controls +that have items.", ""); class wxControlWithItems : public wxControl, public wxItemContainer {