fix docs for wxWindow::Layout (fixes #4297)

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

interface/wx/panel.h

@@ -96,6 +96,12 @@ public:
     */
     virtual void InitDialog();
 
+    /**
+        See wxWindow::SetAutoLayout(): when auto layout is on, this function gets
+        called automatically when the window is resized.
+    */
+    virtual bool Layout();
+
     /**
         The default handler for wxEVT_SYS_COLOUR_CHANGED.
 

interface/wx/toplevel.h

@@ -176,6 +176,12 @@ public:
     */
     bool IsUsingNativeDecorations() const;
 
+    /**
+        See wxWindow::SetAutoLayout(): when auto layout is on, this function gets
+        called automatically when the window is resized.
+    */
+    virtual bool Layout();
+
     /**
         Maximizes or restores the window.
 

interface/wx/window.h

@@ -1503,8 +1503,10 @@ public:
         Invokes the constraint-based layout algorithm or the sizer-based algorithm
         for this window.
 
-        See SetAutoLayout(): when auto layout is on, this function gets called automatically
+        This function does not get called automatically when the window is resized
-        when the window is resized.
+        because lots of windows deriving from wxWindow does not need this functionality.
+        If you want to have Layout() called automatically, you should derive
+        from wxPanel (see wxPanel::Layout).
 
         @see @ref overview_windowsizing
     */
@@ -1981,8 +1983,9 @@ public:
         updated when its size changes.
 
         @param autoLayout
-            Set this to @true if you wish the Layout function to be
+            Set this to @true if you wish the Layout() function to be
-            called automatically when the window is resized.
+            called automatically when the window is resized
+            (really happens only if you derive from wxPanel or wxTopLevelWindow).
 
         @see SetConstraints()
     */