applied doc patch for wxPostEvent().

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

diff --git a/wxPython/src/windows.i b/wxPython/src/windows.i
index 29a0fc72f99138f0b443914c33fa4175efb27bd0..a29f44807064514f28860c96981c858d251edaf4 100644 (file)
--- a/wxPython/src/windows.i
+++ b/wxPython/src/windows.i
@@ -33,10 +33,6 @@
 %pragma(python) code = "import wx"
 
 
 %pragma(python) code = "import wx"
 
 

-%{
-    static wxString wxPyEmptyStr("");
-%}
-

 //---------------------------------------------------------------------------
 
 class wxEvtHandler : public wxObject {
 //---------------------------------------------------------------------------
 
 class wxEvtHandler : public wxObject {


@@ -218,6 +214,7 @@ public:
     %name(FindWindowByName) wxWindow* FindWindow(const wxString& name);
     void Fit();
     wxColour GetBackgroundColour();
     %name(FindWindowByName) wxWindow* FindWindow(const wxString& name);
     void Fit();
     wxColour GetBackgroundColour();

+    wxBorder GetBorder() const;

 
     //wxList& GetChildren();
     %addmethods {
 
     //wxList& GetChildren();
     %addmethods {


@@ -231,6 +228,15 @@ public:
     int  GetCharWidth();
     %name(GetClientSizeTuple) void GetClientSize(int *OUTPUT, int *OUTPUT);
     wxSize GetClientSize();
     int  GetCharWidth();
     %name(GetClientSizeTuple) void GetClientSize(int *OUTPUT, int *OUTPUT);
     wxSize GetClientSize();

+
+    // get the origin of the client area of the window relative to the
+    // window top left corner (the client area may be shifted because of
+    // the borders, scrollbars, other decorations...)
+    wxPoint GetClientAreaOrigin() const;
+
+    // get the client rectangle in window (i.e. client) coordinates
+    wxRect GetClientRect() const;
+

     wxLayoutConstraints * GetConstraints();
     wxEvtHandler* GetEventHandler();
 
     wxLayoutConstraints * GetConstraints();
     wxEvtHandler* GetEventHandler();
 


@@ -264,7 +270,9 @@ public:
     long GetWindowStyleFlag();
     void SetWindowStyleFlag(long style);
     void SetWindowStyle(long style);
     long GetWindowStyleFlag();
     void SetWindowStyleFlag(long style);
     void SetWindowStyle(long style);

+    bool HasScrollbar(int orient) const;

     bool Hide();
     bool Hide();

+    wxHitTest HitTest(const wxPoint& pt);

     void InitDialog();
     bool IsEnabled();
     bool IsExposed( int x, int y, int w=0, int h=0 );
     void InitDialog();
     bool IsEnabled();
     bool IsExposed( int x, int y, int w=0, int h=0 );


@@ -277,12 +285,19 @@ public:
     bool LoadFromResource(wxWindow* parent, const wxString& resourceName, const wxResourceTable* resourceTable = NULL);
     void Lower();
     void MakeModal(bool flag=TRUE);
     bool LoadFromResource(wxWindow* parent, const wxString& resourceName, const wxResourceTable* resourceTable = NULL);
     void Lower();
     void MakeModal(bool flag=TRUE);

-    %name(MoveXY)void Move(int x, int y);
-    void Move(const wxPoint& point);
+    %name(MoveXY)void Move(int x, int y, int flags = wxSIZE_USE_EXISTING);
+    void Move(const wxPoint& point, int flags = wxSIZE_USE_EXISTING);

 
     wxEvtHandler* PopEventHandler(bool deleteHandler = FALSE);
     void PushEventHandler(wxEvtHandler* handler);
 
 
     wxEvtHandler* PopEventHandler(bool deleteHandler = FALSE);
     void PushEventHandler(wxEvtHandler* handler);
 

+        // find the given handler in the event handler chain and remove (but
+        // not delete) it from the event handler chain, return TRUE if it was
+        // found and FALSE otherwise (this also results in an assert failure so
+        // this function should only be called when the handler is supposed to
+        // be there)
+    bool RemoveEventHandler(wxEvtHandler *handler);
+

     %name(PopupMenuXY)bool PopupMenu(wxMenu *menu, int x, int y);
     bool PopupMenu(wxMenu *menu, const wxPoint& pos);
 
     %name(PopupMenuXY)bool PopupMenu(wxMenu *menu, int x, int y);
     bool PopupMenu(wxMenu *menu, const wxPoint& pos);
 


@@ -319,8 +334,8 @@ public:
             self->SetSize(size);
         }
 
             self->SetSize(size);
         }
 

-        void SetPosition(const wxPoint& pos) {
-            self->Move(pos);
+        void SetPosition(const wxPoint& pos, int flags = wxSIZE_USE_EXISTING) {
+            self->Move(pos, flags);

         }
 
         void SetRect(const wxRect& rect, int sizeFlags=wxSIZE_AUTO) {
         }
 
         void SetRect(const wxRect& rect, int sizeFlags=wxSIZE_AUTO) {


@@ -339,6 +354,7 @@ public:
     bool Show(bool show=TRUE);
     bool TransferDataFromWindow();
     bool TransferDataToWindow();
     bool Show(bool show=TRUE);
     bool TransferDataFromWindow();
     bool TransferDataToWindow();

+    void UpdateWindowUI();

     bool Validate();
     void WarpPointer(int x, int y);
 
     bool Validate();
     void WarpPointer(int x, int y);
 


@@ -358,6 +374,10 @@ public:
     void SetSizer(wxSizer* sizer);
     wxSizer* GetSizer();
 
     void SetSizer(wxSizer* sizer);
     wxSizer* GetSizer();
 

+        // Track if this window is a member of a sizer
+    void SetContainingSizer(wxSizer* sizer);
+    wxSizer *GetContainingSizer() const;
+

     wxValidator* GetValidator();
     void SetValidator(const wxValidator& validator);
 
     wxValidator* GetValidator();
     void SetValidator(const wxValidator& validator);
 


@@ -385,6 +405,7 @@ public:
 
     wxString GetHelpText();
     void SetHelpText(const wxString& helpText);
 
     wxString GetHelpText();
     void SetHelpText(const wxString& helpText);

+    void SetHelpTextForId(const wxString& text);

 
     bool ScrollLines(int lines);
     bool ScrollPages(int pages);
 
     bool ScrollLines(int lines);
     bool ScrollPages(int pages);


@@ -405,6 +426,9 @@ public:
     // A way to do the native draw first...  Too bad it isn't in wxGTK too.
     void OnPaint(wxPaintEvent& event);
 #endif
     // A way to do the native draw first...  Too bad it isn't in wxGTK too.
     void OnPaint(wxPaintEvent& event);
 #endif

+
+    wxButton* GetDefaultItem();
+    void SetDefaultItem(wxButton *btn);

 };
 
 
 };
 
 


@@ -460,8 +484,6 @@ public:
     %pragma(python) addtomethod = "wxPrePanel:val._setOORInfo(val)"
 
     void InitDialog();
     %pragma(python) addtomethod = "wxPrePanel:val._setOORInfo(val)"
 
     void InitDialog();

-    wxButton* GetDefaultItem();
-    void SetDefaultItem(wxButton *btn);

 
 };
 
 
 };
 


@@ -523,15 +545,15 @@ public:
 
 class wxMenu : public wxEvtHandler {
 public:
 
 class wxMenu : public wxEvtHandler {
 public:

-    wxMenu(const wxString& title = wxPyEmptyStr, long style = 0);
+    wxMenu(const wxString& title = wxEmptyString, long style = 0);

 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
 
     void Append(int id, const wxString& item,
 
     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
 
     void Append(int id, const wxString& item,

-                const wxString& helpString = wxPyEmptyStr,
+                const wxString& helpString = wxEmptyString,

                 int checkable = FALSE);
     %name(AppendMenu)void Append(int id, const wxString& item, wxMenu *subMenu,
                 int checkable = FALSE);
     %name(AppendMenu)void Append(int id, const wxString& item, wxMenu *subMenu,

-                const wxString& helpString = wxPyEmptyStr);
+                const wxString& helpString = wxEmptyString);

     %name(AppendItem)void Append(const wxMenuItem* item);
 
     void AppendSeparator();
     %name(AppendItem)void Append(const wxMenuItem* item);
 
     void AppendSeparator();


@@ -629,8 +651,8 @@ public:
 class wxMenuItem : public wxObject {
 public:
     wxMenuItem(wxMenu* parentMenu=NULL, int id=wxID_SEPARATOR,
 class wxMenuItem : public wxObject {
 public:
     wxMenuItem(wxMenu* parentMenu=NULL, int id=wxID_SEPARATOR,

-               const wxString& text = wxPyEmptyStr,
-               const wxString& help = wxPyEmptyStr,
+               const wxString& text = wxEmptyString,
+               const wxString& help = wxEmptyString,

                bool isCheckable = FALSE, wxMenu* subMenu = NULL);
 
 
                bool isCheckable = FALSE, wxMenu* subMenu = NULL);