save a reference to the bitmap so it doesn't get destroyed before the

[wxWidgets.git] / wxPython / src / _combobox.i

diff --git a/wxPython/src/_combobox.i b/wxPython/src/_combobox.i
index ab262f9bf14f7de761501e5a321cc4d01a4413a8..d593ea6f120b25800693503956817abbe5b6c31e 100644 (file)
--- a/wxPython/src/_combobox.i
+++ b/wxPython/src/_combobox.i
@@ -22,32 +22,46 @@ MAKE_CONST_WXSTRING(ComboBoxNameStr);
 
 
 DocStr(wxComboBox,
 
 
 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
 #ifdef __WXMSW__
 class wxComboBox : public wxChoice
 #else


@@ -58,8 +72,6 @@ public:
     %pythonAppend wxComboBox         "self._setOORInfo(self)"
     %pythonAppend wxComboBox()       ""
 
     %pythonAppend wxComboBox         "self._setOORInfo(self)"
     %pythonAppend wxComboBox()       ""
 

-    RefDoc(wxComboBox, ""); // turn it off for the ctors
-    

     DocCtorAStr(
         wxComboBox(wxWindow* parent, wxWindowID id=-1,
                    const wxString& value = wxPyEmptyString,
     DocCtorAStr(
         wxComboBox(wxWindow* parent, wxWindowID id=-1,
                    const wxString& value = wxPyEmptyString,


@@ -69,15 +81,15 @@ public:
                    long style = 0,
                    const wxValidator& validator = wxDefaultValidator,
                    const wxString& name = wxPyComboBoxNameStr),
                    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(),
 
     DocCtorStrName(
         wxComboBox(),

-        "Precreate a ComboBox control for 2-phase creation.",
+        "Precreate a ComboBox control for 2-phase creation.", "",

         PreComboBox);
 
 
         PreComboBox);
 
 


@@ -90,82 +102,163 @@ public:
                      long style = 0,
                      const wxValidator& validator = wxDefaultValidator,
                      const wxString& name = wxPyChoiceNameStr),
                      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,
     
 
     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 , SetValue(const wxString& value),

-        "");
+        "", "");

     
 
     DocDeclStr(
         virtual void , Copy(),
     
 
     DocDeclStr(
         virtual void , Copy(),

-        "Copies the selected text to the clipboard.");
+        "Copies the selected text to the clipboard.", "");

     
     DocDeclStr(
         virtual void , Cut(),
     
     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(),
     
     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),
     
     
     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,
     
     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,
     
     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),
     
     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),
     
     DocDeclStr(
         void , SetSelection(int n),

-        "Sets the item at index 'n' to be the selected item.");
+        "Sets the item at index 'n' to be the selected item.", "");

     
     DocDeclStrName(
         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.",
+        "Selects the text between the two positions in the combobox text field.", "",

         SetMark);    
 
         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),
     DocDeclStr(
         bool , SetStringSelection(const wxString& string),

-        "Select the item with the specifed string");
+        "Select the item with the specifed string", "");

     
     DocDeclStr(
         void , SetString(int n, const wxString& string),
     
     DocDeclStr(
         void , SetString(int n, const wxString& string),

-        "Set the label for the n'th item (zero based) in the list.");
+        "Set the label for the n'th item (zero based) in the list.", "");

     
     DocDeclStr(
         virtual void , SetEditable(bool editable),
     
     DocDeclStr(
         virtual void , SetEditable(bool editable),

-        "");
+        "", "");

     
 
     DocDeclStr(
         virtual void , SetInsertionPointEnd(),
     
 
     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),
     
     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`");
+

 };
 
 //---------------------------------------------------------------------------
 };
 
 //---------------------------------------------------------------------------