From: Robin Dunn <robin@alldunn.com>
Date: Thu, 14 Sep 2006 20:27:01 +0000 (+0000)
Subject: docstring update
X-Git-Url: https://git.saurik.com/wxWidgets.git/commitdiff_plain/e393c3fb102d565111b5cf280136a6e8b50bab85?ds=inline

docstring update


git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@41232 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
---

diff --git a/wxPython/src/_event.i b/wxPython/src/_event.i
index c5a444a1cb..c070cf5188 100644
--- a/wxPython/src/_event.i
+++ b/wxPython/src/_event.i
@@ -1622,9 +1622,14 @@ Warning: the window returned may be None!", "");
 %newgroup;
 
 DocStr(wxChildFocusEvent,
-"wx.ChildFocusEvent notifies the parent that a child has received the
-focus.  Unlike `wx.FocusEvent` it is propagated up the window
-heirarchy.", "");
+"A child focus event is sent to a (parent-)window when one of its child
+windows gains focus, so that the window could restore the focus back
+to its corresponding child if it loses it now and regains later.
+
+Notice that child window is the direct child of the window receiving
+the event, and so may not be the actual widget recieving focus if it
+is further down the containment heirarchy.  Use `wx.Window.FindFocus`
+to get the widget that is actually receiving focus.", "");
 
 
 class wxChildFocusEvent : public wxCommandEvent
@@ -1636,7 +1641,8 @@ public:
 
     DocDeclStr(
         wxWindow *, GetWindow() const,
-        "The window which has just received the focus.", "");
+        "The window, or (grand)parent of the window which has just received the
+focus.", "");
 
     %property(Window, GetWindow, doc="See `GetWindow`");
 };