undeprecated wxSizerItem::IsShown() undoing last change to wx/sizer.h: turns out we do need this logic in a few places

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

docs/changes.txt

@@ -16,7 +16,6 @@ Deprecated methods since 2.6.x and their replacements
 
 - wxGetWorkingDirectory() deprecated in favour of wxGetCwd()
 - wxDC::BeginDrawing() and wxDC::EndDrawing() deprecated, just don't use them
-- wxSizerItem::IsShown(): no replacement as it doesn't have clear semantics
 
 
 2.7.0

docs/latex/wx/sizeritem.tex

@@ -155,6 +155,16 @@ If this item is tracking a window then return it.  NULL otherwise.
 Is this item a sizer?
 
 
+\membersection{wxSizerItem::IsShown}\label{wxsizeritemisshown}
+
+\constfunc{bool}{IsShown}{\void}
+
+Returns \true if this item is a window or a spacer and it is shown or if this
+item is a sizer and not all its elements are hidden. In other words, for sizer
+items, all of the child elements must be hidden for the sizer itself to be
+considered hidden.
+
+
 \membersection{wxSizerItem::IsSpacer}\label{wxsizeritemisspacer}
 
 \constfunc{bool}{IsSpacer}{\void}