X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/4582ed947831b29121287904a79a384d16c7aa91..7f4f5e8c24607ead9b5e2f4c60658dcd61f028f4:/interface/wx/window.h diff --git a/interface/wx/window.h b/interface/wx/window.h index 63b2703191..548752f7c9 100644 --- a/interface/wx/window.h +++ b/interface/wx/window.h @@ -1423,8 +1423,14 @@ public: //@{ /** - Clears the window by filling it with the current background colour. Does not - cause an erase background event to be generated. + Clears the window by filling it with the current background colour. + + Does not cause an erase background event to be generated. + + Notice that this uses wxClientDC to draw on the window and the results + of doing it while also drawing on wxPaintDC for this window are + undefined. Hence this method shouldn't be used from EVT_PAINT handlers, + just use wxDC::Clear() on the wxPaintDC you already use there instead. */ virtual void ClearBackground(); @@ -1840,6 +1846,19 @@ public: */ bool ProcessWindowEvent(wxEvent& event); + /** + Wrapper for wxEvtHandler::ProcessEventLocally(). + + This method is similar to ProcessWindowEvent() but can be used to + search for the event handler only in this window and any event handlers + pushed on top of it. Unlike ProcessWindowEvent() it won't propagate the + event upwards. But it will use the validator and event handlers + associated with this window, if any. + + @since 2.9.1 + */ + bool ProcessWindowEventLocally(wxEvent& event); + /** Removes and returns the top-most event handler on the event handler stack. @@ -3153,6 +3172,8 @@ public: The search is recursive in both cases. @see FindWindow() + + @return Window with the given @a id or @NULL if not found. */ static wxWindow* FindWindowById(long id, const wxWindow* parent = 0); @@ -3166,6 +3187,8 @@ public: The search is recursive in both cases. @see FindWindow() + + @return Window with the given @a label or @NULL if not found. */ static wxWindow* FindWindowByLabel(const wxString& label, const wxWindow* parent = 0); @@ -3182,6 +3205,8 @@ public: FindWindowByLabel() is called. @see FindWindow() + + @return Window with the given @a name or @NULL if not found. */ static wxWindow* FindWindowByName(const wxString& name, const wxWindow* parent = 0);