]> git.saurik.com Git - wxWidgets.git/blobdiff - wxPython/src/controls.i
projects / wxWidgets.git / blobdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | inline | side by side
fixed bug in generation of thumb scroll events
[wxWidgets.git] / wxPython / src / controls.i
diff --git a/wxPython/src/controls.i b/wxPython/src/controls.i
index a622b6145d148d5aeeb0c2201d82c87d6b5de77f..64e69048f4daaa54186ea30d77950bc6215334b1 100644 (file)
--- a/wxPython/src/controls.i
+++ b/wxPython/src/controls.i
@@ -30,7 +30,6 @@
 #ifdef __WXGTK__
 #include <wx/checklst.h>
 #endif
 #ifdef __WXGTK__
 #include <wx/checklst.h>
 #endif
-
 %}
 
 //----------------------------------------------------------------------
 %}
 
 //----------------------------------------------------------------------
@@ -55,30 +54,74 @@ wxValidator wxDefaultValidator;
 
 //----------------------------------------------------------------------
 
 
 //----------------------------------------------------------------------
 
+%{
+//#define DECLARE_DEF_STRING(name)  static wxString* wxPy##name
+
+    // Put some wx default wxChar* values into wxStrings.
+    DECLARE_DEF_STRING(ControlNameStr);
+    DECLARE_DEF_STRING(ButtonNameStr);
+    DECLARE_DEF_STRING(CheckBoxNameStr);
+    DECLARE_DEF_STRING(ChoiceNameStr);
+    DECLARE_DEF_STRING(ComboBoxNameStr);
+    DECLARE_DEF_STRING(GaugeNameStr);
+    DECLARE_DEF_STRING(StaticBoxNameStr);
+    DECLARE_DEF_STRING(StaticTextNameStr);
+    DECLARE_DEF_STRING(ListBoxNameStr);
+    DECLARE_DEF_STRING(TextCtrlNameStr);
+    DECLARE_DEF_STRING(ScrollBarNameStr);
+    DECLARE_DEF_STRING(SPIN_BUTTON_NAME);
+    DECLARE_DEF_STRING(StaticBitmapNameStr);
+    DECLARE_DEF_STRING(RadioBoxNameStr);
+    DECLARE_DEF_STRING(RadioButtonNameStr);
+    DECLARE_DEF_STRING(SliderNameStr);
+
+    wxChar* wxSpinCtrlNameStr = _T("wxSpinCtrl");
+    DECLARE_DEF_STRING(SpinCtrlNameStr);
+
+    static const wxString wxPyEmptyString(wxT(""));
+%}
+
+//----------------------------------------------------------------------
+
+//  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.
 class wxControl : public wxWindow {
 public:
 class wxControl : public wxWindow {
 public:
+
+    //
     wxControl(wxWindow *parent,
                        wxWindowID id,
                        const wxPoint& pos=wxDefaultPosition,
                        const wxSize& size=wxDefaultSize,
                        long style=0,
                        const wxValidator& validator=wxDefaultValidator,
     wxControl(wxWindow *parent,
                        wxWindowID id,
                        const wxPoint& pos=wxDefaultPosition,
                        const wxSize& size=wxDefaultSize,
                        long style=0,
                        const wxValidator& validator=wxDefaultValidator,
-                       const char* name="control");
+                       const wxString& name=wxPyControlNameStr);
+
+    //
     %name(wxPreControl)wxControl();
 
     %name(wxPreControl)wxControl();
 
+    //
     bool Create(wxWindow *parent,
                        wxWindowID id,
                        const wxPoint& pos=wxDefaultPosition,
                        const wxSize& size=wxDefaultSize,
                        long style=0,
                        const wxValidator& validator=wxDefaultValidator,
     bool Create(wxWindow *parent,
                        wxWindowID id,
                        const wxPoint& pos=wxDefaultPosition,
                        const wxSize& size=wxDefaultSize,
                        long style=0,
                        const wxValidator& validator=wxDefaultValidator,
-                       const char* name="control");
+                       const wxString& name=wxPyControlNameStr);
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreControl:val._setOORInfo(val)"
 
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreControl:val._setOORInfo(val)"
 
+    // Simulates the effect of the user issuing a command to the item. See
+    // wxCommandEvent.
     void Command(wxCommandEvent& event);
     void Command(wxCommandEvent& event);
+
+    // Return a control's text.
     wxString GetLabel();
     wxString GetLabel();
+
+    // Sets the item's text.
     void SetLabel(const wxString& label);
 };
 
     void SetLabel(const wxString& label);
 };
 
@@ -90,24 +133,42 @@ class wxControlWithItems : public wxControl {
 public:
 
     // void Clear();  ambiguous, redefine below...
 public:
 
     // void Clear();  ambiguous, redefine below...
+
+    // Deletes an item from the control
     void Delete(int n);
 
     void Delete(int n);
 
+    // Returns the number of items in the control.
     int GetCount();
     %pragma(python) addtoclass = "Number = GetCount"
     int GetCount();
     %pragma(python) addtoclass = "Number = GetCount"
+
+    // Returns the string at the given position.
     wxString GetString(int n);
     wxString GetString(int n);
+
+    // Sets the string value of an item.
     void SetString(int n, const wxString& s);
     void SetString(int n, const wxString& s);
+
+    // Finds an item matching the given string.  Returns the zero-based
+    // position of the item, or -1 if the string was not found.
     int FindString(const wxString& s);
 
     int FindString(const wxString& s);
 
+    // Select the item at postion n.
     void Select(int n);
     void Select(int n);
+
+    // Gets the position of the selected item.
     int GetSelection();
 
     int GetSelection();
 
+    // Gets the current selection as a string.
     wxString GetStringSelection() const;
 
     //   void Append(const wxString& item);
     //   void Append(const wxString& item, char* clientData);
     //   char* GetClientData(const int n);
     //   void SetClientData(const int n, char* data);
     wxString GetStringSelection() const;
 
     //   void Append(const wxString& item);
     //   void Append(const wxString& item, char* clientData);
     //   char* GetClientData(const int n);
     //   void SetClientData(const int n, char* data);
+
+
     %addmethods {
     %addmethods {
+        // Adds the item to the control, associating the given data with the
+        // item if not None.
         void Append(const wxString& item, PyObject* clientData=NULL) {
             if (clientData) {
                 wxPyClientData* data = new wxPyClientData(clientData);
         void Append(const wxString& item, PyObject* clientData=NULL) {
             if (clientData) {
                 wxPyClientData* data = new wxPyClientData(clientData);
@@ -116,6 +177,7 @@ public:
                 self->Append(item);
         }
 
                 self->Append(item);
         }
 
+        // Returns the client data associated with the given item, (if any.)
         PyObject* GetClientData(int n) {
             wxPyClientData* data = (wxPyClientData*)self->GetClientObject(n);
             if (data) {
         PyObject* GetClientData(int n) {
             wxPyClientData* data = (wxPyClientData*)self->GetClientObject(n);
             if (data) {
@@ -127,42 +189,93 @@ public:
             }
         }
 
             }
         }
 
+        // 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);
         }
     }
 
         void SetClientData(int n, PyObject* clientData) {
             wxPyClientData* data = new wxPyClientData(clientData);
             self->SetClientObject(n, data);
         }
     }
 
+    // append several items at once to the control
+    %name(AppendItems)void Append(const wxArrayString& strings);
+
 };
 };
+
 //----------------------------------------------------------------------
 
 //----------------------------------------------------------------------
 
+// A button is a control that contains a text string, and is one of the most
+// common elements of a GUI.  It may be placed on a dialog box or panel, or
+// indeed almost any other window.
+//
+// Styles
+//    wxBU_LEFT:  Left-justifies the label. WIN32 only.
+//    wxBU_TOP:  Aligns the label to the top of the button. WIN32 only.
+//    wxBU_RIGHT:  Right-justifies the bitmap label. WIN32 only.
+//    wxBU_BOTTOM:  Aligns the label to the bottom of the button. WIN32 only.
+//    wxBU_EXACTFIT: Creates the button as small as possible instead of making
+//                   it of the standard size (which is the default behaviour.)
+//
+// Events
+//     EVT_BUTTON(win,id,func):
+//         Sent when the button is clicked.
+//
 class wxButton : public wxControl {
 public:
 class wxButton : public wxControl {
 public:
+    // Constructor, creating and showing a button.
+    //
+    // parent:  Parent window.  Must not be None.
+    // id:      Button identifier.  A value of -1 indicates a default value.
+    // label:   The text to be displayed on the button.
+    // pos:     The button position on it's parent.
+    // size:    Button size.  If the default size (-1, -1) is specified then the
+    //          button is sized appropriately for the text.
+    // style:   Window style.  See wxButton.
+    // validator: Window validator.
+    // name:    Window name.
     wxButton(wxWindow* parent, wxWindowID id, const wxString& label,
              const wxPoint& pos = wxDefaultPosition,
              const wxSize& size = wxDefaultSize,
              long style = 0,
              const wxValidator& validator = wxDefaultValidator,
     wxButton(wxWindow* parent, wxWindowID id, const wxString& label,
              const wxPoint& pos = wxDefaultPosition,
              const wxSize& size = wxDefaultSize,
              long style = 0,
              const wxValidator& validator = wxDefaultValidator,
-             char* name = "button");
+             const wxString& name = wxPyButtonNameStr);
+
+    // Default constructor
     %name(wxPreButton)wxButton();
 
     %name(wxPreButton)wxButton();
 
+    // Button creation function for two-step creation.
     bool Create(wxWindow* parent, wxWindowID id, const wxString& label,
              const wxPoint& pos = wxDefaultPosition,
              const wxSize& size = wxDefaultSize,
              long style = 0,
              const wxValidator& validator = wxDefaultValidator,
     bool Create(wxWindow* parent, wxWindowID id, const wxString& label,
              const wxPoint& pos = wxDefaultPosition,
              const wxSize& size = wxDefaultSize,
              long style = 0,
              const wxValidator& validator = wxDefaultValidator,
-             char* name = "button");
+             const wxString& name = wxPyButtonNameStr);
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreButton:val._setOORInfo(val)"
 
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreButton:val._setOORInfo(val)"
 
+    // This sets the button to be the default item for the panel or dialog box.
+    //
+    // Under Windows, only dialog box buttons respond to this function. As
+    // normal under Windows and Motif, pressing return causes the default
+    // button to be depressed when the return key is pressed. See also
+    // wxWindow.SetFocus which sets the keyboard focus for windows and text
+    // panel items, and wxPanel.SetDefaultItem.
     void SetDefault();
     void SetDefault();
+
+    //
     void SetBackgroundColour(const wxColour& colour);
     void SetBackgroundColour(const wxColour& colour);
+    //
     void SetForegroundColour(const wxColour& colour);
     void SetForegroundColour(const wxColour& colour);
+
 #ifdef __WXMSW__
 #ifdef __WXMSW__
+    // show the image in the button in addition to the label
     void SetImageLabel(const wxBitmap& bitmap);
     void SetImageLabel(const wxBitmap& bitmap);
+
+    // set the margins around the image
     void SetImageMargins(wxCoord x, wxCoord y);
 #endif
     void SetImageMargins(wxCoord x, wxCoord y);
 #endif
+
+    // returns the default button size for this platform
     static wxSize GetDefaultSize();
 };
 
     static wxSize GetDefaultSize();
 };
 
@@ -175,7 +288,7 @@ public:
                    const wxSize& size = wxDefaultSize,
                    long style = wxBU_AUTODRAW,
                    const wxValidator& validator = wxDefaultValidator,
                    const wxSize& size = wxDefaultSize,
                    long style = wxBU_AUTODRAW,
                    const wxValidator& validator = wxDefaultValidator,
-                   char* name = "button");
+                   const wxString& name = wxPyButtonNameStr);
     %name(wxPreBitmapButton)wxBitmapButton();
 
     bool Create(wxWindow* parent, wxWindowID id, const wxBitmap& bitmap,
     %name(wxPreBitmapButton)wxBitmapButton();
 
     bool Create(wxWindow* parent, wxWindowID id, const wxBitmap& bitmap,
@@ -183,7 +296,7 @@ public:
                    const wxSize& size = wxDefaultSize,
                    long style = wxBU_AUTODRAW,
                    const wxValidator& validator = wxDefaultValidator,
                    const wxSize& size = wxDefaultSize,
                    long style = wxBU_AUTODRAW,
                    const wxValidator& validator = wxDefaultValidator,
-                   char* name = "button");
+                const wxString& name = wxPyButtonNameStr);
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreBitmapButton:val._setOORInfo(val)"
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreBitmapButton:val._setOORInfo(val)"
@@ -211,7 +324,7 @@ public:
                const wxSize& size = wxDefaultSize,
                long style = 0,
                const wxValidator& val = wxDefaultValidator,
                const wxSize& size = wxDefaultSize,
                long style = 0,
                const wxValidator& val = wxDefaultValidator,
-               char* name = "checkBox");
+               const wxString& name = wxPyCheckBoxNameStr);
     %name(wxPreCheckBox)wxCheckBox();
 
     bool Create(wxWindow* parent, wxWindowID id, const wxString& label,
     %name(wxPreCheckBox)wxCheckBox();
 
     bool Create(wxWindow* parent, wxWindowID id, const wxString& label,
@@ -219,7 +332,7 @@ public:
                const wxSize& size = wxDefaultSize,
                long style = 0,
                const wxValidator& val = wxDefaultValidator,
                const wxSize& size = wxDefaultSize,
                long style = 0,
                const wxValidator& val = wxDefaultValidator,
-               char* name = "checkBox");
+               const wxString& name = wxPyCheckBoxNameStr);
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreCheckBox:val._setOORInfo(val)"
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreCheckBox:val._setOORInfo(val)"
@@ -238,7 +351,7 @@ public:
              int LCOUNT=0, wxString* choices=NULL,
              long style = 0,
              const wxValidator& validator = wxDefaultValidator,
              int LCOUNT=0, wxString* choices=NULL,
              long style = 0,
              const wxValidator& validator = wxDefaultValidator,
-             char* name = "choice");
+             const wxString& name = wxPyChoiceNameStr);
     %name(wxPreChoice)wxChoice();
 
     bool Create(wxWindow *parent, wxWindowID id,
     %name(wxPreChoice)wxChoice();
 
     bool Create(wxWindow *parent, wxWindowID id,
@@ -247,7 +360,7 @@ public:
              int LCOUNT=0, wxString* choices=NULL,
              long style = 0,
              const wxValidator& validator = wxDefaultValidator,
              int LCOUNT=0, wxString* choices=NULL,
              long style = 0,
              const wxValidator& validator = wxDefaultValidator,
-             char* name = "choice");
+             const wxString& name = wxPyChoiceNameStr);
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreChoice:val._setOORInfo(val)"
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreChoice:val._setOORInfo(val)"
@@ -275,22 +388,24 @@ public:
 class wxComboBox : public wxControl
 {
 public:
 class wxComboBox : public wxControl
 {
 public:
-    wxComboBox(wxWindow* parent, wxWindowID id, char* value = "",
+    wxComboBox(wxWindow* parent, wxWindowID id,
+               const wxString& value = wxPyEmptyString,
                const wxPoint& pos = wxDefaultPosition,
                const wxSize& size = wxDefaultSize,
                int LCOUNT=0, wxString* choices=NULL,
                long style = 0,
                const wxValidator& validator = wxDefaultValidator,
                const wxPoint& pos = wxDefaultPosition,
                const wxSize& size = wxDefaultSize,
                int LCOUNT=0, wxString* choices=NULL,
                long style = 0,
                const wxValidator& validator = wxDefaultValidator,
-               char* name = "comboBox");
+               const wxString& name = wxPyComboBoxNameStr);
     %name(wxPreComboBox)wxComboBox();
 
     %name(wxPreComboBox)wxComboBox();
 
-    bool Create(wxWindow* parent, wxWindowID id, char* value = "",
-               const wxPoint& pos = wxDefaultPosition,
-               const wxSize& size = wxDefaultSize,
-               int LCOUNT=0, wxString* choices=NULL,
-               long style = 0,
-               const wxValidator& validator = wxDefaultValidator,
-               char* name = "comboBox");
+    bool Create(wxWindow* parent, wxWindowID id,
+                const wxString& value = wxPyEmptyString,
+                const wxPoint& pos = wxDefaultPosition,
+                const wxSize& size = wxDefaultSize,
+                int LCOUNT=0, wxString* choices=NULL,
+                long style = 0,
+                const wxValidator& validator = wxDefaultValidator,
+                const wxString& name = wxPyComboBoxNameStr);
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreComboBox:val._setOORInfo(val)"
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreComboBox:val._setOORInfo(val)"
@@ -366,22 +481,24 @@ public:
 
 class wxComboBox : public wxChoice {
 public:
 
 class wxComboBox : public wxChoice {
 public:
-    wxComboBox(wxWindow* parent, wxWindowID id, char* value = "",
+    wxComboBox(wxWindow* parent, wxWindowID id,
+               const wxString& value = wxPyEmptyString,
                const wxPoint& pos = wxDefaultPosition,
                const wxSize& size = wxDefaultSize,
                int LCOUNT=0, wxString* choices=NULL,
                long style = 0,
                const wxValidator& validator = wxDefaultValidator,
                const wxPoint& pos = wxDefaultPosition,
                const wxSize& size = wxDefaultSize,
                int LCOUNT=0, wxString* choices=NULL,
                long style = 0,
                const wxValidator& validator = wxDefaultValidator,
-               char* name = "comboBox");
+               const wxString& name = wxPyComboBoxNameStr);
     %name(wxPreComboBox)wxComboBox();
 
     %name(wxPreComboBox)wxComboBox();
 
-    bool Create(wxWindow* parent, wxWindowID id, char* value = "",
+    bool Create(wxWindow* parent, wxWindowID id,
+               const wxString& value = wxPyEmptyString,
                const wxPoint& pos = wxDefaultPosition,
                const wxSize& size = wxDefaultSize,
                int LCOUNT=0, wxString* choices=NULL,
                long style = 0,
                const wxValidator& validator = wxDefaultValidator,
                const wxPoint& pos = wxDefaultPosition,
                const wxSize& size = wxDefaultSize,
                int LCOUNT=0, wxString* choices=NULL,
                long style = 0,
                const wxValidator& validator = wxDefaultValidator,
-               char* name = "comboBox");
+               const wxString& name = wxPyComboBoxNameStr);
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreComboBox:val._setOORInfo(val)"
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreComboBox:val._setOORInfo(val)"
@@ -413,7 +530,7 @@ public:
             const wxSize& size = wxDefaultSize,
             long style = wxGA_HORIZONTAL,
             const wxValidator& validator = wxDefaultValidator,
             const wxSize& size = wxDefaultSize,
             long style = wxGA_HORIZONTAL,
             const wxValidator& validator = wxDefaultValidator,
-            char* name = "gauge");
+            const wxString& name = wxPyGaugeNameStr);
     %name(wxPreGauge)wxGauge();
 
     bool Create(wxWindow* parent, wxWindowID id, int range,
     %name(wxPreGauge)wxGauge();
 
     bool Create(wxWindow* parent, wxWindowID id, int range,
@@ -421,7 +538,7 @@ public:
             const wxSize& size = wxDefaultSize,
             long style = wxGA_HORIZONTAL,
             const wxValidator& validator = wxDefaultValidator,
             const wxSize& size = wxDefaultSize,
             long style = wxGA_HORIZONTAL,
             const wxValidator& validator = wxDefaultValidator,
-            char* name = "gauge");
+            const wxString& name = wxPyGaugeNameStr);
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreGauge:val._setOORInfo(val)"
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreGauge:val._setOORInfo(val)"
@@ -444,14 +561,14 @@ public:
                 const wxPoint& pos = wxDefaultPosition,
                 const wxSize& size = wxDefaultSize,
                 long style = 0,
                 const wxPoint& pos = wxDefaultPosition,
                 const wxSize& size = wxDefaultSize,
                 long style = 0,
-                char* name = "staticBox");
+                const wxString& name = wxPyStaticBoxNameStr);
     %name(wxPreStaticBox)wxStaticBox();
 
     bool Create(wxWindow* parent, wxWindowID id, const wxString& label,
                 const wxPoint& pos = wxDefaultPosition,
                 const wxSize& size = wxDefaultSize,
                 long style = 0,
     %name(wxPreStaticBox)wxStaticBox();
 
     bool Create(wxWindow* parent, wxWindowID id, const wxString& label,
                 const wxPoint& pos = wxDefaultPosition,
                 const wxSize& size = wxDefaultSize,
                 long style = 0,
-                char* name = "staticBox");
+                const wxString& name = wxPyStaticBoxNameStr);
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreStaticBox:val._setOORInfo(val)"
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreStaticBox:val._setOORInfo(val)"
@@ -467,14 +584,14 @@ public:
                   const wxPoint &pos = wxDefaultPosition,
                   const wxSize &size = wxDefaultSize,
                   long style = wxLI_HORIZONTAL,
                   const wxPoint &pos = wxDefaultPosition,
                   const wxSize &size = wxDefaultSize,
                   long style = wxLI_HORIZONTAL,
-                  const char* name = "staticLine" );
+                  const wxString& name = wxPyStaticTextNameStr);
     %name(wxPreStaticLine)wxStaticLine();
 
     bool Create( wxWindow *parent, wxWindowID id,
                   const wxPoint &pos = wxDefaultPosition,
                   const wxSize &size = wxDefaultSize,
                   long style = wxLI_HORIZONTAL,
     %name(wxPreStaticLine)wxStaticLine();
 
     bool Create( wxWindow *parent, wxWindowID id,
                   const wxPoint &pos = wxDefaultPosition,
                   const wxSize &size = wxDefaultSize,
                   long style = wxLI_HORIZONTAL,
-                  const char* name = "staticLine" );
+                  const wxString& name = wxPyStaticTextNameStr);
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreStaticLine:val._setOORInfo(val)"
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreStaticLine:val._setOORInfo(val)"
@@ -489,14 +606,14 @@ public:
                  const wxPoint& pos = wxDefaultPosition,
                  const wxSize& size = wxDefaultSize,
                  long style = 0,
                  const wxPoint& pos = wxDefaultPosition,
                  const wxSize& size = wxDefaultSize,
                  long style = 0,
-                 char* name = "staticText");
+                 const wxString& name = wxPyStaticTextNameStr);
     %name(wxPreStaticText)wxStaticText();
 
     bool Create(wxWindow* parent, wxWindowID id, const wxString& label,
                  const wxPoint& pos = wxDefaultPosition,
                  const wxSize& size = wxDefaultSize,
                  long style = 0,
     %name(wxPreStaticText)wxStaticText();
 
     bool Create(wxWindow* parent, wxWindowID id, const wxString& label,
                  const wxPoint& pos = wxDefaultPosition,
                  const wxSize& size = wxDefaultSize,
                  long style = 0,
-                 char* name = "staticText");
+                 const wxString& name = wxPyStaticTextNameStr);
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreStaticText:val._setOORInfo(val)"
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreStaticText:val._setOORInfo(val)"
@@ -515,7 +632,7 @@ public:
               int LCOUNT, wxString* choices = NULL,
               long style = 0,
               const wxValidator& validator = wxDefaultValidator,
               int LCOUNT, wxString* choices = NULL,
               long style = 0,
               const wxValidator& validator = wxDefaultValidator,
-              char* name = "listBox");
+              const wxString& name = wxPyListBoxNameStr);
     %name(wxPreListBox)wxListBox();
 
     bool Create(wxWindow* parent, wxWindowID id,
     %name(wxPreListBox)wxListBox();
 
     bool Create(wxWindow* parent, wxWindowID id,
@@ -524,7 +641,7 @@ public:
               int LCOUNT, wxString* choices = NULL,
               long style = 0,
               const wxValidator& validator = wxDefaultValidator,
               int LCOUNT, wxString* choices = NULL,
               long style = 0,
               const wxValidator& validator = wxDefaultValidator,
-              char* name = "listBox");
+              const wxString& name = wxPyListBoxNameStr);
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreListBox:val._setOORInfo(val)"
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreListBox:val._setOORInfo(val)"
@@ -570,7 +687,7 @@ public:
                    wxString* choices = NULL,
                    long style = 0,
                    const wxValidator& validator = wxDefaultValidator,
                    wxString* choices = NULL,
                    long style = 0,
                    const wxValidator& validator = wxDefaultValidator,
-                   char* name = "listBox");
+                   const wxString& name = wxPyListBoxNameStr);
     %name(wxPreCheckListBox)wxCheckListBox();
 
     bool Create(wxWindow *parent, wxWindowID id,
     %name(wxPreCheckListBox)wxCheckListBox();
 
     bool Create(wxWindow *parent, wxWindowID id,
@@ -580,7 +697,7 @@ public:
                    wxString* choices = NULL,
                    long style = 0,
                    const wxValidator& validator = wxDefaultValidator,
                    wxString* choices = NULL,
                    long style = 0,
                    const wxValidator& validator = wxDefaultValidator,
-                   char* name = "listBox");
+                   const wxString& name = wxPyListBoxNameStr);
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreCheckListBox:val._setOORInfo(val)"
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreCheckListBox:val._setOORInfo(val)"
@@ -635,20 +752,22 @@ public:
 
 class wxTextCtrl : public wxControl {
 public:
 
 class wxTextCtrl : public wxControl {
 public:
-    wxTextCtrl(wxWindow* parent, wxWindowID id, char* value = "",
+    wxTextCtrl(wxWindow* parent, wxWindowID id,
+               const wxString& value = wxPyEmptyString,
                const wxPoint& pos = wxDefaultPosition,
                const wxSize& size = wxDefaultSize,
                long style = 0,
                const wxValidator& validator = wxDefaultValidator,
                const wxPoint& pos = wxDefaultPosition,
                const wxSize& size = wxDefaultSize,
                long style = 0,
                const wxValidator& validator = wxDefaultValidator,
-               char* name = "text");
+               const wxString& name = wxPyTextCtrlNameStr);
     %name(wxPreTextCtrl)wxTextCtrl();
 
     %name(wxPreTextCtrl)wxTextCtrl();
 
-    bool Create(wxWindow* parent, wxWindowID id, char* value = "",
+    bool Create(wxWindow* parent, wxWindowID id,
+               const wxString& value = wxPyEmptyString,
                const wxPoint& pos = wxDefaultPosition,
                const wxSize& size = wxDefaultSize,
                long style = 0,
                const wxValidator& validator = wxDefaultValidator,
                const wxPoint& pos = wxDefaultPosition,
                const wxSize& size = wxDefaultSize,
                long style = 0,
                const wxValidator& validator = wxDefaultValidator,
-               char* name = "text");
+               const wxString& name = wxPyTextCtrlNameStr);
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreTextCtrl:val._setOORInfo(val)"
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreTextCtrl:val._setOORInfo(val)"
@@ -657,6 +776,8 @@ public:
     wxString GetValue() const;
     void SetValue(const wxString& value);
 
     wxString GetValue() const;
     void SetValue(const wxString& value);
 
+    wxString GetRange(long from, long to);
+
     int GetLineLength(long lineNo) const;
     wxString GetLineText(long lineNo) const;
     int GetNumberOfLines() const;
     int GetLineLength(long lineNo) const;
     wxString GetLineText(long lineNo) const;
     int GetNumberOfLines() const;
@@ -674,7 +795,7 @@ public:
 
     // load/save the controls contents from/to the file
     bool LoadFile(const wxString& file);
 
     // load/save the controls contents from/to the file
     bool LoadFile(const wxString& file);
-    bool SaveFile(const wxString& file = wxEmptyString);
+    bool SaveFile(const wxString& file = wxPyEmptyString);
 
     // clears the dirty flag
     void DiscardEdits();
 
     // clears the dirty flag
     void DiscardEdits();
@@ -688,6 +809,10 @@ public:
     void WriteText(const wxString& text);
     void AppendText(const wxString& text);
 
     void WriteText(const wxString& text);
     void AppendText(const wxString& text);
 
+    // insert the character which would have resulted from this key event,
+    // return TRUE if anything has been inserted
+    bool EmulateKeyPress(const wxKeyEvent& event);
+
     // text control under some platforms supports the text styles: these
     // methods allow to apply the given text style to the given selection or to
     // set/get the style which will be used for all appended text
     // text control under some platforms supports the text styles: these
     // methods allow to apply the given text style to the given selection or to
     // set/get the style which will be used for all appended text
@@ -699,7 +824,10 @@ public:
     // considering all its contents as a single strings) and (x, y) coordinates
     // which represent column and line.
     long XYToPosition(long x, long y) const;
     // considering all its contents as a single strings) and (x, y) coordinates
     // which represent column and line.
     long XYToPosition(long x, long y) const;
-    bool PositionToXY(long pos, long *OUTPUT, long *OUTPUT) const;
+    void PositionToXY(long pos, long *OUTPUT, long *OUTPUT) const;
+
+    //bool PositionToXY(long pos, long *OUTPUT, long *OUTPUT) const;
+    // TODO: check return value, raise exception.
 
     void ShowPosition(long pos);
 
 
     void ShowPosition(long pos);
 
@@ -752,7 +880,7 @@ public:
                 const wxSize& size = wxDefaultSize,
                 long style = wxSB_HORIZONTAL,
                 const wxValidator& validator = wxDefaultValidator,
                 const wxSize& size = wxDefaultSize,
                 long style = wxSB_HORIZONTAL,
                 const wxValidator& validator = wxDefaultValidator,
-                char* name = "scrollBar");
+                const wxString& name = wxPyScrollBarNameStr);
     %name(wxPreScrollBar)wxScrollBar();
 
     bool Create(wxWindow* parent, wxWindowID id = -1,
     %name(wxPreScrollBar)wxScrollBar();
 
     bool Create(wxWindow* parent, wxWindowID id = -1,
@@ -760,7 +888,7 @@ public:
                 const wxSize& size = wxDefaultSize,
                 long style = wxSB_HORIZONTAL,
                 const wxValidator& validator = wxDefaultValidator,
                 const wxSize& size = wxDefaultSize,
                 long style = wxSB_HORIZONTAL,
                 const wxValidator& validator = wxDefaultValidator,
-                char* name = "scrollBar");
+                const wxString& name = wxPyScrollBarNameStr);
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreScrollBar:val._setOORInfo(val)"
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreScrollBar:val._setOORInfo(val)"
@@ -787,14 +915,14 @@ public:
                  const wxPoint& pos = wxDefaultPosition,
                  const wxSize& size = wxDefaultSize,
                  long style = wxSP_HORIZONTAL,
                  const wxPoint& pos = wxDefaultPosition,
                  const wxSize& size = wxDefaultSize,
                  long style = wxSP_HORIZONTAL,
-                 char* name = "spinButton");
+                 const wxString& name = wxPySPIN_BUTTON_NAME);
     %name(wxPreSpinButton)wxSpinButton();
 
     bool Create(wxWindow* parent, wxWindowID id = -1,
                  const wxPoint& pos = wxDefaultPosition,
                  const wxSize& size = wxDefaultSize,
                  long style = wxSP_HORIZONTAL,
     %name(wxPreSpinButton)wxSpinButton();
 
     bool Create(wxWindow* parent, wxWindowID id = -1,
                  const wxPoint& pos = wxDefaultPosition,
                  const wxSize& size = wxDefaultSize,
                  long style = wxSP_HORIZONTAL,
-                 char* name = "spinButton");
+                 const wxString& name = wxPySPIN_BUTTON_NAME);
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreSpinButton:val._setOORInfo(val)"
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreSpinButton:val._setOORInfo(val)"
@@ -815,7 +943,7 @@ public:
                    const wxPoint& pos = wxDefaultPosition,
                    const wxSize& size = wxDefaultSize,
                    long style = 0,
                    const wxPoint& pos = wxDefaultPosition,
                    const wxSize& size = wxDefaultSize,
                    long style = 0,
-                   char* name = "staticBitmap");
+                   const wxString& name = wxPyStaticBitmapNameStr);
     %name(wxPreStaticBitmap)wxStaticBitmap();
 
     bool Create(wxWindow* parent, wxWindowID id,
     %name(wxPreStaticBitmap)wxStaticBitmap();
 
     bool Create(wxWindow* parent, wxWindowID id,
@@ -823,7 +951,7 @@ public:
                    const wxPoint& pos = wxDefaultPosition,
                    const wxSize& size = wxDefaultSize,
                    long style = 0,
                    const wxPoint& pos = wxDefaultPosition,
                    const wxSize& size = wxDefaultSize,
                    long style = 0,
-                   char* name = "staticBitmap");
+                   const wxString& name = wxPyStaticBitmapNameStr);
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreStaticBitmap:val._setOORInfo(val)"
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreStaticBitmap:val._setOORInfo(val)"
@@ -845,7 +973,7 @@ public:
                int majorDimension = 0,
                long style = wxRA_HORIZONTAL,
                const wxValidator& validator = wxDefaultValidator,
                int majorDimension = 0,
                long style = wxRA_HORIZONTAL,
                const wxValidator& validator = wxDefaultValidator,
-               char* name = "radioBox");
+               const wxString& name = wxPyRadioBoxNameStr);
     %name(wxPreRadioBox)wxRadioBox();
 
     bool Create(wxWindow* parent, wxWindowID id,
     %name(wxPreRadioBox)wxRadioBox();
 
     bool Create(wxWindow* parent, wxWindowID id,
@@ -856,7 +984,7 @@ public:
                int majorDimension = 0,
                long style = wxRA_HORIZONTAL,
                const wxValidator& validator = wxDefaultValidator,
                int majorDimension = 0,
                long style = wxRA_HORIZONTAL,
                const wxValidator& validator = wxDefaultValidator,
-               char* name = "radioBox");
+               const wxString& name = wxPyRadioBoxNameStr);
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreRadioBox:val._setOORInfo(val)"
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreRadioBox:val._setOORInfo(val)"
@@ -901,7 +1029,7 @@ public:
                   const wxSize& size = wxDefaultSize,
                   long style = 0,
                   const wxValidator& validator = wxDefaultValidator,
                   const wxSize& size = wxDefaultSize,
                   long style = 0,
                   const wxValidator& validator = wxDefaultValidator,
-                  char* name = "radioButton");
+                  const wxString& name = wxPyRadioButtonNameStr);
     %name(wxPreRadioButton)wxRadioButton();
 
     bool Create(wxWindow* parent, wxWindowID id,
     %name(wxPreRadioButton)wxRadioButton();
 
     bool Create(wxWindow* parent, wxWindowID id,
@@ -910,7 +1038,7 @@ public:
                   const wxSize& size = wxDefaultSize,
                   long style = 0,
                   const wxValidator& validator = wxDefaultValidator,
                   const wxSize& size = wxDefaultSize,
                   long style = 0,
                   const wxValidator& validator = wxDefaultValidator,
-                  char* name = "radioButton");
+                  const wxString& name = wxPyRadioButtonNameStr);
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreRadioButton:val._setOORInfo(val)"
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreRadioButton:val._setOORInfo(val)"
@@ -929,7 +1057,7 @@ public:
              const wxSize& size = wxDefaultSize,
              long style = wxSL_HORIZONTAL,
              const wxValidator& validator = wxDefaultValidator,
              const wxSize& size = wxDefaultSize,
              long style = wxSL_HORIZONTAL,
              const wxValidator& validator = wxDefaultValidator,
-             char* name = "slider");
+             const wxString& name = wxPySliderNameStr);
     %name(wxPreSlider)wxSlider();
 
     bool Create(wxWindow* parent, wxWindowID id,
     %name(wxPreSlider)wxSlider();
 
     bool Create(wxWindow* parent, wxWindowID id,
@@ -938,7 +1066,7 @@ public:
              const wxSize& size = wxDefaultSize,
              long style = wxSL_HORIZONTAL,
              const wxValidator& validator = wxDefaultValidator,
              const wxSize& size = wxDefaultSize,
              long style = wxSL_HORIZONTAL,
              const wxValidator& validator = wxDefaultValidator,
-             char* name = "slider");
+             const wxString& name = wxPySliderNameStr);
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreSlider:val._setOORInfo(val)"
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreSlider:val._setOORInfo(val)"
@@ -971,22 +1099,22 @@ class wxSpinCtrl : public wxSpinButton {
 public:
     wxSpinCtrl(wxWindow *parent,
                wxWindowID id = -1,
 public:
     wxSpinCtrl(wxWindow *parent,
                wxWindowID id = -1,
-               const char* value = "",
+               const wxString& value = wxPyEmptyString,
                const wxPoint& pos = wxDefaultPosition,
                const wxSize& size = wxDefaultSize,
                long style = wxSP_ARROW_KEYS,
                int min = 0, int max = 100, int initial = 0,
                const wxPoint& pos = wxDefaultPosition,
                const wxSize& size = wxDefaultSize,
                long style = wxSP_ARROW_KEYS,
                int min = 0, int max = 100, int initial = 0,
-               const char* name = "wxSpinCtrl");
+               const wxString& name = wxPySpinCtrlNameStr);
     %name(wxPreSpinCtrl)wxSpinCtrl();
 
     bool Create(wxWindow *parent,
                wxWindowID id = -1,
     %name(wxPreSpinCtrl)wxSpinCtrl();
 
     bool Create(wxWindow *parent,
                wxWindowID id = -1,
-               const char* value = "",
+               const wxString& value = wxPyEmptyString,
                const wxPoint& pos = wxDefaultPosition,
                const wxSize& size = wxDefaultSize,
                long style = wxSP_ARROW_KEYS,
                int min = 0, int max = 100, int initial = 0,
                const wxPoint& pos = wxDefaultPosition,
                const wxSize& size = wxDefaultSize,
                long style = wxSP_ARROW_KEYS,
                int min = 0, int max = 100, int initial = 0,
-               const char* name = "wxSpinCtrl");
+               const wxString& name = wxPySpinCtrlNameStr);
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreSpinCtrl:val._setOORInfo(val)"
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreSpinCtrl:val._setOORInfo(val)"
@@ -1014,7 +1142,7 @@ public:
                    const wxSize& size = wxDefaultSize,
                    long style = 0,
                    const wxValidator& validator = wxDefaultValidator,
                    const wxSize& size = wxDefaultSize,
                    long style = 0,
                    const wxValidator& validator = wxDefaultValidator,
-                   const char* name = "toggle");
+                   const wxString& name = wxPyCheckBoxNameStr);
     %name(wxPreToggleButton)wxToggleButton();
 
     bool Create(wxWindow *parent,
     %name(wxPreToggleButton)wxToggleButton();
 
     bool Create(wxWindow *parent,
@@ -1024,7 +1152,7 @@ public:
                    const wxSize& size = wxDefaultSize,
                    long style = 0,
                    const wxValidator& validator = wxDefaultValidator,
                    const wxSize& size = wxDefaultSize,
                    long style = 0,
                    const wxValidator& validator = wxDefaultValidator,
-                   const char* name = "toggle");
+                   const wxString& name = wxPyCheckBoxNameStr);
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreToggleButton:val._setOORInfo(val)"
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
     %pragma(python) addtomethod = "wxPreToggleButton:val._setOORInfo(val)"
@@ -1036,6 +1164,7 @@ public:
 };
 
 #endif
 };
 
 #endif
+
 //----------------------------------------------------------------------
 //----------------------------------------------------------------------
 //----------------------------------------------------------------------
 //----------------------------------------------------------------------
 //----------------------------------------------------------------------
 //----------------------------------------------------------------------
wxWidgets (Impactor)