Document that wxWindow::FindWindowByXXX() functions may return NULL.

This seems obvious but apparently isn't completely so to everybody.

Closes #12074.

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

diff --git a/interface/wx/window.h b/interface/wx/window.h
index 4ac6a5b0a3b338183e15eb9e84597a02e5681d5d..548752f7c97f8aeb74b23a40f65a5d67a4d8bcb0 100644 (file)
--- a/interface/wx/window.h
+++ b/interface/wx/window.h
@@ -3172,6 +3172,8 @@ public:
         The search is recursive in both cases.
 
         @see FindWindow()
         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);
 
     */
     static wxWindow* FindWindowById(long id, const wxWindow* parent = 0);
 


@@ -3185,6 +3187,8 @@ public:
         The search is recursive in both cases.
 
         @see FindWindow()
         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);
     */
     static wxWindow* FindWindowByLabel(const wxString& label,
                                        const wxWindow* parent = 0);


@@ -3201,6 +3205,8 @@ public:
         FindWindowByLabel() is called.
 
         @see FindWindow()
         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);
     */
     static wxWindow* FindWindowByName(const wxString& name,
                                       const wxWindow* parent = 0);