mention that creation time only lives up to its name under Windows

[wxWidgets.git] / docs / latex / wx / splitevt.tex

diff --git a/docs/latex/wx/splitevt.tex b/docs/latex/wx/splitevt.tex
index c525bcafe284f6a3130249395352f2b318519b41..1b57bba02db0c8e5d0254df91f3249f0d401d769 100644 (file)
--- a/docs/latex/wx/splitevt.tex
+++ b/docs/latex/wx/splitevt.tex
@@ -1,12 +1,17 @@
 \section{\class{wxSplitterEvent}}\label{wxsplitterevent}
 
-This class represents the events generated by a splitter control.
+This class represents the events generated by a splitter control. Also there is
+only one event class, the data associated to the different events is not the
+same and so not all accessor functions may be called for each event. The
+documentation mentions the kind of event(s) for which the given acessor
+function makes sense: calling it for other types of events will result
+in assert failure (in debug mode) and will return meaningless results.
 
 \wxheading{Derived from}
 
+\helpref{wxNotifyEvent}{wxnotifyevent}\\
 \helpref{wxCommandEvent}{wxcommandevent}\\
 \helpref{wxEvent}{wxevent}\\
-\helpref{wxEvtHandler}{wxevthandler}\\
 \helpref{wxObject}{wxobject}
 
 \wxheading{Include files}
@@ -18,27 +23,37 @@ This class represents the events generated by a splitter control.
 To process a splitter event, use these event handler macros to direct input to member
 functions that take a wxSplitterEvent argument.
 
-\twocolwidtha{7cm}
+\twocolwidtha{10cm}
 \begin{twocollist}\itemsep=0pt
-\twocolitem{{\bf EVT\_SPLITTER\_SASH\_POS\_CHANGED(id, func)}
-    {The sash position was changed. May be used to prevent the change from
-     taking place. Processes wxEVT\_COMMAND\_SPLITTER\_SASH\_POS\_CHANGED event.}
-\twocolitem{{\bf EVT\_SPLITTER\_UNSPLIT(id, func)}}
-    {The splitter has been just unsplit. Processes wxEVT\_COMMAND\_SPLITTER\_UNSPLIT
-     event.}
-\twocolitem{{\bf EVT\_SPLITTER\_DOUBLECLICKED(id, func)}}
-    {The sash was double clicked. The default behaviour is to unsplit the
-     window when this happens (unless the minimum pane size has been set to a
-     value greater than zero). Processes wxEVT\_COMMAND\_SPLITTER\_DOUBLECLICKED
-     event}
+\twocolitem{{\bf EVT\_SPLITTER\_SASH\_POS\_CHANGING(id, func)}}{The sash
+position is in the process of being changed. You may prevent this change
+from happening by calling \helpref{Veto}{wxnotifyeventveto} or you may also
+modify the position of the tracking bar to properly reflect the position that
+would be set if the drag were to be completed at this point. Processes a
+wxEVT\_COMMAND\_SPLITTER\_SASH\_POS\_CHANGING event.}
+\twocolitem{{\bf EVT\_SPLITTER\_SASH\_POS\_CHANGED(id, func)}}{The sash
+position was changed. May be used to modify the sash position before
+it is set, or to prevent the change from taking place.
+Processes a wxEVT\_COMMAND\_SPLITTER\_SASH\_POS\_CHANGED event.}
+\twocolitem{{\bf EVT\_SPLITTER\_UNSPLIT(id, func)}}{The splitter has been just
+unsplit. Processes a wxEVT\_COMMAND\_SPLITTER\_UNSPLIT event. This event can't
+be vetoed.}
+\twocolitem{{\bf EVT\_SPLITTER\_DOUBLECLICKED(id, func)}}{The sash was double
+clicked. The default behaviour is to unsplit the window when this happens
+(unless the minimum pane size has been set to a value greater than zero). This
+won't happen if you veto this event. Processes a
+wxEVT\_COMMAND\_SPLITTER\_DOUBLECLICKED event.}
 \end{twocollist}%
 
 \wxheading{See also}
 
-\helpref{wxSplitterWindow}{wxsplitterwindow}
+\helpref{wxSplitterWindow}{wxsplitterwindow},\rtfsp
+\helpref{Event handling overview}{eventhandlingoverview}
+
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
+
 \membersection{wxSplitterEvent::wxSplitterEvent}\label{wxsplittereventconstr}
 
 \func{}{wxSplitterEvent}{\param{wxEventType}{ eventType = wxEVT\_NULL},
@@ -46,4 +61,64 @@ functions that take a wxSplitterEvent argument.
 
 Constructor. Used internally by wxWindows only.
 
-% TODO
+
+\membersection{wxSplitterEvent::GetSashPosition}\label{wxsplittereventgetsashposition}
+
+\constfunc{int}{GetSashPosition}{\void}
+
+Returns the new sash position.
+
+May only be called while processing
+wxEVT\_COMMAND\_SPLITTER\_SASH\_POS\_CHANGING and
+wxEVT\_COMMAND\_SPLITTER\_SASH\_POS\_CHANGED events.
+
+
+\membersection{wxSplitterEvent::GetX}\label{wxsplittereventgetx}
+
+\constfunc{int}{GetX}{\void}
+
+Returns the x coordinate of the double-click point.
+
+May only be called while processing
+wxEVT\_COMMAND\_SPLITTER\_DOUBLECLICKED events.
+
+
+\membersection{wxSplitterEvent::GetY}\label{wxsplittereventgety}
+
+\constfunc{int}{GetY}{\void}
+
+Returns the y coordinate of the double-click point.
+
+May only be called while processing
+wxEVT\_COMMAND\_SPLITTER\_DOUBLECLICKED events.
+
+\membersection{wxSplitterEvent::GetWindowBeingRemoved}\label{wxsplittereventgetwindowbeingremoved}
+
+\constfunc{wxWindow*}{GetWindowBeingRemoved}{\void}
+
+Returns a pointer to the window being removed when a splitter window
+is unsplit.
+
+May only be called while processing
+wxEVT\_COMMAND\_SPLITTER\_UNSPLIT events.
+
+
+\membersection{wxSplitterEvent::SetSashPosition}\label{wxsplittereventsetsashposition}
+
+\func{void}{SetSashPosition}{\param{int}{ pos}}
+
+In the case of wxEVT\_COMMAND\_SPLITTER\_SASH\_POS\_CHANGED events,
+sets the the new sash position. In the case of
+wxEVT\_COMMAND\_SPLITTER\_SASH\_POS\_CHANGING events, sets the new
+tracking bar position so visual feedback during dragging will
+represent that change that will actually take place. Set to -1 from
+the event handler code to prevent repositioning.
+
+May only be called while processing
+wxEVT\_COMMAND\_SPLITTER\_SASH\_POS\_CHANGING and
+wxEVT\_COMMAND\_SPLITTER\_SASH\_POS\_CHANGED events.
+
+\wxheading{Parameters}
+
+\docparam{pos}{New sash position.}
+