improve wxTreeItemData documentation (closes #10662)

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

diff --git a/interface/wx/treebase.h b/interface/wx/treebase.h
index 4961f6678185098eaa92f8a273efe1de0516816c..e9eaf7da5d6bef9d45db4980749828dcb576f79f 100644 (file)
--- a/interface/wx/treebase.h
+++ b/interface/wx/treebase.h
@@ -92,6 +92,12 @@ public:
 
     /**
         Sets the item associated with this node.
+
+        Notice that this function is automatically called by wxTreeCtrl methods
+        associating an object of this class with a tree control item such as
+        wxTreeCtrl::AppendItem(), wxTreeCtrl::InsertItem() and
+        wxTreeCtrl::SetItemData() so there is usually no need to call it
+        yourself.
     */
     void SetId(const wxTreeItemId& id);
 };

diff --git a/interface/wx/treectrl.h b/interface/wx/treectrl.h
index 9e439555988ec3bcaa44b7e95a656a2d9eb665ae..d4da034876e48b71efbd491eb3a8112bc0972e81 100644 (file)
--- a/interface/wx/treectrl.h
+++ b/interface/wx/treectrl.h
@@ -774,6 +774,11 @@ public:
     /**
         Sets the item client data.
 
+        Notice that the client data previously associated with the @a item (if
+        any) is @em not freed by this function and so calling this function
+        multiple times for the same item will result in memory leaks unless you
+        delete the old item data pointer yourself.
+
         @beginWxPythonOnly
         - @b SetPyData( @a item, @c obj): Associate the given Python Object with
             the wxTreeItemData for the given item Id.