document that SetItemCount() doesn't have to refresh the control (to avoid problems...

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

diff --git a/interface/listctrl.h b/interface/listctrl.h
index 31e28708a7b715220bf65c389ff627c5f57891fe..df70624f85539aff6a201b8764e9a6ab06039e5f 100644 (file)
--- a/interface/listctrl.h
+++ b/interface/listctrl.h
@@ -832,11 +832,17 @@ The m_stateMask and m_state members take flags from the following:
     bool SetItemColumnImage(long item, long column, int image);
 
     /**
-    This method can only be used with virtual list controls. It is used to indicate
-    to the control the number of items it contains. After calling it, the main
-    program should be ready to handle calls to various item callbacks (such as
-    wxListCtrl::OnGetItemText) for all items in the range
-    from 0 to @e count.
+        This method can only be used with virtual list controls.
+
+        It is used to indicate to the control the number of items it contains.
+        After calling it, the main program should be ready to handle calls to
+        various item callbacks (such as wxListCtrl::OnGetItemText) for all
+        items in the range from 0 to @a count.
+
+        Notice that the control is not necessarily redrawn after this call as
+        it may be undesirable if an item which is not visible on the screen
+        anyhow was added to or removed from a control displaying many items, if
+        you do need to refresh the display you can just call Refresh() manually.
     */
     void SetItemCount(long count);