docs/latex/wx/sashwin.tex

   1 \section{\class{wxSashWindow}}\label{wxsashwindow}
   2
   3 wxSashWindow allows any of its edges to have a sash which can be dragged
   4 to resize the window. The actual content window will be created by the application
   5 as a child of wxSashWindow. The window (or an ancestor) will be notified of a drag
   6 via a \helpref{wxSashEvent}{wxsashevent} notification.
   7
   8 \wxheading{Derived from}
   9
  10 \helpref{wxWindow}{wxwindow}\\
  11 \helpref{wxEvtHandler}{wxevthandler}\\
  12 \helpref{wxObject}{wxobject}
  13
  14 \wxheading{Include files}
  15
  16 <wx/sashwin.h>
  17
  18 \wxheading{Window styles}
  19
  20 The following styles apply in addition to the normal wxWindow styles.
  21
  22 \twocolwidtha{5cm}%
  23 \begin{twocollist}\itemsep=0pt
  24 \twocolitem{\windowstyle{wxSW\_3D}}{Draws the sashes in 3D.}
  25 \end{twocollist}
  26
  27 See also \helpref{window styles overview}{windowstyles}.
  28
  29 \wxheading{Event handling}
  30
  31 \twocolwidtha{7cm}%
  32 \begin{twocollist}\itemsep=0pt
  33 \twocolitem{{\bf EVT\_SASH\_DRAGGED(id, func)}}{Process a wxEVT\_SASH\_DRAGGED event,
  34 when the user has finished dragging a sash.}
  35 \twocolitem{{\bf EVT\_SASH\_DRAGGED\_RANGE(id1, id2, func)}}{Process a wxEVT\_SASH\_DRAGGED\_RANGE event,
  36 when the user has finished dragging a sash. The event handler is called when windows with ids in the
  37 given range have their sashes dragged.}
  38 \end{twocollist}
  39
  40 \wxheading{Data types}
  41
  42 {\small
  43 \begin{verbatim}
  44 enum wxSashEdgePosition {
  45     wxSASH_TOP = 0,
  46     wxSASH_RIGHT,
  47     wxSASH_BOTTOM,
  48     wxSASH_LEFT,
  49     wxSASH_NONE = 100
  50 };
  51 \end{verbatim}
  52 }
  53
  54 \wxheading{See also}
  55
  56 \helpref{wxSashEvent}{wxsashevent}, \helpref{wxSashLayoutWindow}{wxsashlayoutwindow}, \helpref{Event handling overview}{eventhandlingoverview}
  57
  58 \latexignore{\rtfignore{\wxheading{Members}}}
  59
  60 \membersection{wxSashWindow::wxSashWindow}
  61
  62 \func{}{wxSashWindow}{\void}
  63
  64 Default constructor.
  65
  66 \func{}{wxSashWindow}{\param{wxSashWindow*}{ parent}, \param{wxSashWindowID }{id},
  67  \param{const wxPoint\& }{pos = wxDefaultPosition},
  68  \param{const wxSize\& }{size = wxDefaultSize},
  69  \param{long }{style = wxCLIP\_CHILDREN \pipe wxSW\_3D},
  70  \param{const wxString\& }{name = "sashWindow"}}
  71
  72 Constructs a sash window, which can be a child of a frame, dialog or any other non-control window.
  73
  74 \wxheading{Parameters}
  75
  76 \docparam{parent}{Pointer to a parent window.}
  77
  78 \docparam{id}{Window identifier. If -1, will automatically create an identifier.}
  79
  80 \docparam{pos}{Window position. wxDefaultPosition is (-1, -1) which indicates that wxSashWindows
  81 should generate a default position for the window. If using the wxSashWindow class directly, supply
  82 an actual position.}
  83
  84 \docparam{size}{Window size. wxDefaultSize is (-1, -1) which indicates that wxSashWindows
  85 should generate a default size for the window.}
  86
  87 \docparam{style}{Window style. For window styles, please see \helpref{wxSashWindow}{wxsashwindow}.}
  88
  89 \docparam{name}{Window name.}
  90
  91 \membersection{wxSashWindow::\destruct{wxSashWindow}}
  92
  93 \func{}{\destruct{wxSashWindow}}{\void}
  94
  95 Destructor.
  96
  97 \membersection{wxSashWindow::GetSashVisible}\label{wxsashwindowgetsashvisible}
  98
  99 \constfunc{bool}{GetSashVisible}{\param{wxSashEdgePosition }{edge}}
 100
 101 Returns TRUE if a sash is visible on the given edge, FALSE otherwise.
 102
 103 \wxheading{Parameters}
 104
 105 \docparam{edge}{Edge. One of wxSASH\_TOP, wxSASH\_RIGHT, wxSASH\_BOTTOM, wxSASH\_LEFT.}
 106
 107 \wxheading{See also}
 108
 109 \helpref{wxSashWindow::SetSashVisible}{wxsashwindowsetsashvisible}
 110
 111 \membersection{wxSashWindow::GetMaximumSizeX}\label{wxsashwindowgetmaximumsizex}
 112
 113 \constfunc{int}{GetMaximumSizeX}{\void}
 114
 115 Gets the maximum window size in the x direction.
 116
 117 \membersection{wxSashWindow::GetMaximumSizeY}\label{wxsashwindowgetmaximumsizey}
 118
 119 \constfunc{int}{GetMaximumSizeY}{\void}
 120
 121 Gets the maximum window size in the y direction.
 122
 123 \membersection{wxSashWindow::GetMinimumSizeX}\label{wxsashwindowgetminimumsizex}
 124
 125 \func{int}{GetMinimumSizeX}{\void}
 126
 127 Gets the minimum window size in the x direction.
 128
 129 \membersection{wxSashWindow::GetMinimumSizeY}\label{wxsashwindowgetminimumsizey}
 130
 131 \constfunc{int}{GetMinimumSizeY}{\param{int}{ min}}
 132
 133 Gets the minimum window size in the y direction.
 134
 135 \membersection{wxSashWindow::HasBorder}\label{wxsashwindowhasborder}
 136
 137 \constfunc{bool}{HasBorder}{\param{wxSashEdgePosition }{edge}}
 138
 139 Returns TRUE if the sash has a border, FALSE otherwise.
 140
 141 \wxheading{Parameters}
 142
 143 \docparam{edge}{Edge. One of wxSASH\_TOP, wxSASH\_RIGHT, wxSASH\_BOTTOM, wxSASH\_LEFT.}
 144
 145 \wxheading{See also}
 146
 147 \helpref{wxSashWindow::SetSashBorder}{wxsashwindowsetsashborder}
 148
 149 \membersection{wxSashWindow::SetMaximumSizeX}\label{wxsashwindowsetmaximumsizex}
 150
 151 \func{void}{SetMaximumSizeX}{\param{int}{ min}}
 152
 153 Sets the maximum window size in the x direction.
 154
 155 \membersection{wxSashWindow::SetMaximumSizeY}\label{wxsashwindowsetmaximumsizey}
 156
 157 \func{void}{SetMaximumSizeY}{\param{int}{ min}}
 158
 159 Sets the maximum window size in the y direction.
 160
 161 \membersection{wxSashWindow::SetMinimumSizeX}\label{wxsashwindowsetminimumsizex}
 162
 163 \func{void}{SetMinimumSizeX}{\param{int}{ min}}
 164
 165 Sets the minimum window size in the x direction.
 166
 167 \membersection{wxSashWindow::SetMinimumSizeY}\label{wxsashwindowsetminimumsizey}
 168
 169 \func{void}{SetMinimumSizeY}{\param{int}{ min}}
 170
 171 Sets the minimum window size in the y direction.
 172
 173 \membersection{wxSashWindow::SetSashVisible}\label{wxsashwindowsetsashvisible}
 174
 175 \func{void}{SetSashVisible}{\param{wxSashEdgePosition }{edge}, \param{bool}{ visible}}
 176
 177 Call this function to make a sash visible or invisible on a particular edge.
 178
 179 \wxheading{Parameters}
 180
 181 \docparam{edge}{Edge to change. One of wxSASH\_TOP, wxSASH\_RIGHT, wxSASH\_BOTTOM, wxSASH\_LEFT.}
 182
 183 \docparam{visible}{TRUE to make the sash visible, FALSE to make it invisible.}
 184
 185 \wxheading{See also}
 186
 187 \helpref{wxSashWindow::GetSashVisible}{wxsashwindowgetsashvisible}
 188
 189 \membersection{wxSashWindow::SetSashBorder}\label{wxsashwindowsetsashborder}
 190
 191 \func{void}{SetSashBorder}{\param{wxSashEdgePosition }{edge}, \param{bool}{ hasBorder}}
 192
 193 Call this function to give the sash a border, or remove the border.
 194
 195 \wxheading{Parameters}
 196
 197 \docparam{edge}{Edge to change. One of wxSASH\_TOP, wxSASH\_RIGHT, wxSASH\_BOTTOM, wxSASH\_LEFT.}
 198
 199 \docparam{hasBorder}{TRUE to give the sash a border visible, FALSE to remove it.}
 200
 201 \wxheading{See also}
 202
 203 \helpref{wxSashWindow::HashBorder}{wxsashwindowhasborder}
 204