X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/42e69d6b435a4dd5415caf3750db62cf45b6f373..a9249b2eb2a40d8c71f828669045c4ddaa8dc5ff:/docs/latex/wx/splitevt.tex diff --git a/docs/latex/wx/splitevt.tex b/docs/latex/wx/splitevt.tex index c525bcafe2..ffaff7fcf2 100644 --- a/docs/latex/wx/splitevt.tex +++ b/docs/latex/wx/splitevt.tex @@ -1,12 +1,16 @@ \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{wxCommandEvent}{wxcommandevent}\\ \helpref{wxEvent}{wxevent}\\ -\helpref{wxEvtHandler}{wxevthandler}\\ \helpref{wxObject}{wxobject} \wxheading{Include files} @@ -18,27 +22,34 @@ 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. May be used to 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.} +\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 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 +57,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.} +