]>
Commit | Line | Data |
---|---|---|
8fe05782 VZ |
1 | \section{\class{wxSizer}}\label{wxsizer} |
2 | ||
7e9a386e | 3 | wxSizer is the abstract base class used for laying out subwindows in a window. You |
3baaf313 VZ |
4 | cannot use wxSizer directly; instead, you will have to use one of the sizer |
5 | classes derived from it. Currently there are \helpref{wxBoxSizer}{wxboxsizer}, | |
6 | \helpref{wxStaticBoxSizer}{wxstaticboxsizer}, | |
c6eb7785 | 7 | \helpref{wxGridSizer}{wxgridsizer} |
b19d7524 | 8 | \helpref{wxFlexGridSizer}{wxflexgridsizer} and \helpref{wxGridBagSizer}{wxgridbagsizer}. |
515da557 | 9 | |
fc2171bd | 10 | The layout algorithm used by sizers in wxWidgets is closely related to layout |
515da557 RR |
11 | in other GUI toolkits, such as Java's AWT, the GTK toolkit or the Qt toolkit. It is |
12 | based upon the idea of the individual subwindows reporting their minimal required | |
13 | size and their ability to get stretched if the size of the parent window has changed. | |
749bb9f1 DS |
14 | This will most often mean that the programmer does not set the original size of |
15 | a dialog in the beginning, rather the dialog will be assigned a sizer and this sizer | |
1193d8fa RR |
16 | will be queried about the recommended size. The sizer in turn will query its |
17 | children, which can be normal windows, empty space or other sizers, so that | |
18 | a hierarchy of sizers can be constructed. Note that wxSizer does not derive from wxWindow | |
749bb9f1 | 19 | and thus does not interfere with tab ordering and requires very little resources compared |
515da557 RR |
20 | to a real window on screen. |
21 | ||
fc2171bd | 22 | What makes sizers so well fitted for use in wxWidgets is the fact that every control |
515da557 RR |
23 | reports its own minimal size and the algorithm can handle differences in font sizes |
24 | or different window (dialog item) sizes on different platforms without problems. If e.g. | |
25 | the standard font as well as the overall design of Motif widgets requires more space than | |
f6bcfd97 | 26 | on Windows, the initial dialog size will automatically be bigger on Motif than on Windows. |
8fe05782 | 27 | |
e6994168 VZ |
28 | Sizers may also be used to control the layout of custom drawn items on the window. The |
29 | Add, Insert, and Prepend functions return a pointer to the newly added wxSizerItem. Just | |
30 | add empty space of the desired size and attributes, and then use the wxSizerItem::GetRect | |
31 | method to determine where the drawing operations should take place. | |
32 | ||
33 | ||
c1073b57 VZ |
34 | Please notice that sizers, like child windows, are owned by the library and |
35 | will be deleted by it which implies that they must be allocated on the heap. | |
36 | However if you create a sizer and do not add it to another sizer or window, the | |
37 | library wouldn't be able to delete such an orphan sizer and in this, and only | |
38 | this, case it should be deleted explicitly. | |
39 | ||
76e1c2de | 40 | \pythonnote{If you wish to create a sizer class in wxPython you should |
c9110876 | 41 | derive the class from {\tt wxPySizer} in order to get Python-aware |
76e1c2de RD |
42 | capabilities for the various virtual methods.} |
43 | ||
8fe05782 VZ |
44 | \wxheading{Derived from} |
45 | ||
749bb9f1 DS |
46 | \helpref{wxObject}{wxobject}\\ |
47 | \helpref{wxClientDataContainer}{wxclientdatacontainer} | |
8fe05782 | 48 | |
0bf97466 RN |
49 | \wxheading{Include files} |
50 | ||
51 | <wx/sizer.h> | |
52 | ||
1c0c339c JS |
53 | \wxheading{See also} |
54 | ||
55 | \helpref{Sizer overview}{sizeroverview} | |
56 | ||
8fe05782 VZ |
57 | \latexignore{\rtfignore{\wxheading{Members}}} |
58 | ||
02c6137e | 59 | |
8fe05782 VZ |
60 | \membersection{wxSizer::wxSizer}\label{wxsizerwxsizer} |
61 | ||
62 | \func{}{wxSizer}{\void} | |
63 | ||
9c884972 RR |
64 | The constructor. Note that wxSizer is an abstract base class and may not |
65 | be instantiated. | |
8fe05782 | 66 | |
02c6137e | 67 | |
8fe05782 VZ |
68 | \membersection{wxSizer::\destruct{wxSizer}}\label{wxsizerdtor} |
69 | ||
70 | \func{}{\destruct{wxSizer}}{\void} | |
71 | ||
9c884972 | 72 | The destructor. |
8fe05782 | 73 | |
02c6137e | 74 | |
8fe05782 VZ |
75 | \membersection{wxSizer::Add}\label{wxsizeradd} |
76 | ||
40210d8a RN |
77 | \func{wxSizerItem*}{Add}{\param{wxWindow* }{window}, \param{const wxSizerFlags\& }{flags}} |
78 | ||
56eee37f | 79 | \func{wxSizerItem*}{Add}{\param{wxWindow* }{window}, \param{int }{proportion = 0},\param{int }{flag = 0}, \param{int }{border = 0}, \param{wxObject* }{userData = NULL}} |
8fe05782 | 80 | |
40210d8a RN |
81 | \func{wxSizerItem*}{Add}{\param{wxSizer* }{sizer}, \param{const wxSizerFlags\& }{flags}} |
82 | ||
56eee37f | 83 | \func{wxSizerItem*}{Add}{\param{wxSizer* }{sizer}, \param{int }{proportion = 0}, \param{int }{flag = 0}, \param{int }{border = 0}, \param{wxObject* }{userData = NULL}} |
8fe05782 | 84 | |
56eee37f | 85 | \func{wxSizerItem*}{Add}{\param{int }{width}, \param{int }{height}, \param{int }{proportion = 0}, \param{int }{flag = 0}, \param{int }{border = 0}, \param{wxObject* }{userData = NULL}} |
8fe05782 | 86 | |
00976fe5 RL |
87 | Appends a child to the sizer. wxSizer itself is an abstract class, but the parameters are |
88 | equivalent in the derived classes that you will instantiate to use it so they are described | |
89 | here: | |
8fe05782 | 90 | |
4130b487 RR |
91 | \docparam{window}{The window to be added to the sizer. Its initial size (either set explicitly by the |
92 | user or calculated internally when using wxDefaultSize) is interpreted as the minimal and in many | |
f6bcfd97 | 93 | cases also the initial size. This is particularly useful in connection with \helpref{SetSizeHints}{wxsizersetsizehints}.} |
4130b487 RR |
94 | |
95 | \docparam{sizer}{The (child-)sizer to be added to the sizer. This allows placing a child sizer in a | |
96 | sizer and thus to create hierarchies of sizers (typically a vertical box as the top sizer and several | |
97 | horizontal boxes on the level beneath).} | |
98 | ||
99 | \docparam{width and height}{The dimension of a spacer to be added to the sizer. Adding spacers to sizers | |
2edb0bde | 100 | gives more flexibility in the design of dialogs; imagine for example a horizontal box with two buttons at the |
4130b487 | 101 | bottom of a dialog: you might want to insert a space between the two buttons and make that space stretchable |
e3950b18 | 102 | using the \arg{proportion} flag and the result will be that the left button will be aligned with the left |
4130b487 RR |
103 | side of the dialog and the right button with the right side - the space in between will shrink and grow with |
104 | the dialog.} | |
105 | ||
2b5f62a0 | 106 | \docparam{proportion}{Although the meaning of this parameter is undefined in wxSizer, it is used in wxBoxSizer |
a6f3598d | 107 | to indicate if a child of a sizer can change its size in the main orientation of the wxBoxSizer - where |
2edb0bde | 108 | 0 stands for not changeable and a value of more than zero is interpreted relative to the value of other |
f6bcfd97 BP |
109 | children of the same wxBoxSizer. For example, you might have a horizontal wxBoxSizer with three children, two |
110 | of which are supposed to change their size with the sizer. Then the two stretchable windows would get a | |
fc9c7c09 | 111 | value of 1 each to make them grow and shrink equally with the sizer's horizontal dimension.} |
a6f3598d | 112 | |
caa251e0 RD |
113 | \docparam{flag}{This parameter can be used to set a number of flags |
114 | which can be combined using the binary OR operator |. Two main | |
115 | behaviours are defined using these flags. One is the border around a | |
e3950b18 | 116 | window: the \arg{border} parameter determines the border width whereas |
caa251e0 RD |
117 | the flags given here determine which side(s) of the item that the |
118 | border will be added. The other flags determine how the sizer item | |
119 | behaves when the space allotted to the sizer changes, and is somewhat | |
120 | dependent on the specific kind of sizer used. | |
121 | ||
122 | \twocolwidtha{5cm}% | |
123 | \begin{twocollist}\itemsep=0pt | |
124 | \twocolitem{\windowstyle{wxTOP}\\ | |
125 | \windowstyle{wxBOTTOM}\\ | |
126 | \windowstyle{wxLEFT}\\ | |
127 | \windowstyle{wxRIGHT}\\ | |
128 | \windowstyle{wxALL}}{These flags are used to specify which side(s) of | |
e3950b18 | 129 | the sizer item the \arg{border} width will apply to. } |
75173186 | 130 | |
a70b2f80 DS |
131 | \twocolitem{\windowstyle{wxEXPAND}}{The item will be expanded to fill |
132 | the space assigned to the item.} | |
caa251e0 RD |
133 | \twocolitem{\windowstyle{wxSHAPED}}{The item will be expanded as much |
134 | as possible while also maintaining its aspect ratio} | |
2fa2b11b JS |
135 | \twocolitem{\windowstyle{wxFIXED\_MINSIZE}}{Normally wxSizers will use |
136 | \helpref{GetAdjustedBestSize}{wxwindowgetadjustedbestsize} to | |
137 | determine what the minimal size of window items should be, and will | |
138 | use that size to calculate the layout. This allows layouts to | |
e3950b18 | 139 | adjust when an item changes and its \arg{best size} becomes |
2fa2b11b JS |
140 | different. If you would rather have a window item stay the size it |
141 | started with then use wxFIXED\_MINSIZE.} | |
b219a1a9 | 142 | \twocolitem{\windowstyle{wxALIGN\_CENTER wxALIGN\_CENTRE}\\ |
caa251e0 RD |
143 | \windowstyle{wxALIGN\_LEFT}\\ |
144 | \windowstyle{wxALIGN\_RIGHT}\\ | |
145 | \windowstyle{wxALIGN\_TOP}\\ | |
146 | \windowstyle{wxALIGN\_BOTTOM}\\ | |
b219a1a9 VZ |
147 | \windowstyle{wxALIGN\_CENTER\_VERTICAL wxALIGN\_CENTRE\_VERTICAL}\\ |
148 | \windowstyle{wxALIGN\_CENTER\_HORIZONTAL wxALIGN\_CENTRE\_HORIZONTAL}}{The wxALIGN flags allow you to | |
2fa2b11b JS |
149 | specify the alignment of the item within the space allotted to it by |
150 | the sizer, adjusted for the border if any.} | |
caa251e0 RD |
151 | \end{twocollist} |
152 | } | |
153 | ||
e3950b18 | 154 | \docparam{border}{Determines the border width, if the \arg{flag} |
caa251e0 | 155 | parameter is set to include any border flag.} |
a6f3598d | 156 | |
76e1c2de RD |
157 | \docparam{userData}{Allows an extra object to be attached to the sizer |
158 | item, for use in derived classes when sizing information is more | |
e3950b18 | 159 | complex than the \arg{proportion} and \arg{flag} will allow for.} |
f6bcfd97 | 160 | |
40210d8a RN |
161 | \docparam{flags}{A \helpref{wxSizerFlags}{wxsizerflags} object that |
162 | enables you to specify most of the above parameters more conveniently.} | |
02c6137e | 163 | |
749bb9f1 DS |
164 | \membersection{wxSizer::AddSpacer}\label{wxsizeraddspacer} |
165 | ||
56eee37f | 166 | \func{wxSizerItem*}{AddSpacer}{\param{int }{size}} |
749bb9f1 DS |
167 | |
168 | Adds non-stretchable space to the sizer. More readable way of calling | |
169 | \helpref{Add}{wxsizeradd}(size, size, 0). | |
170 | ||
171 | ||
172 | \membersection{wxSizer::AddStretchSpacer}\label{wxsizeraddstretchspacer} | |
173 | ||
56eee37f | 174 | \func{wxSizerItem*}{AddStretchSpacer}{\param{int }{prop = 1}} |
749bb9f1 DS |
175 | |
176 | Adds stretchable space to the sizer. More readable way of calling | |
177 | \helpref{Add}{wxsizeradd}(0, 0, prop). | |
178 | ||
179 | ||
f6bcfd97 BP |
180 | \membersection{wxSizer::CalcMin}\label{wxsizercalcmin} |
181 | ||
182 | \func{wxSize}{CalcMin}{\void} | |
183 | ||
184 | This method is abstract and has to be overwritten by any derived class. | |
185 | Here, the sizer will do the actual calculation of its children minimal sizes. | |
186 | ||
02c6137e | 187 | |
e3950b18 VZ |
188 | \membersection{wxSizer::Clear}\label{wxsizerclear} |
189 | ||
190 | \func{void}{Clear}{\param{bool }{delete\_windows = false}} | |
191 | ||
192 | Detaches all children from the sizer. If \arg{delete\_windows} is \true then child windows will also be deleted. | |
193 | ||
194 | ||
00976fe5 RL |
195 | \membersection{wxSizer::Detach}\label{wxsizerdetach} |
196 | ||
197 | \func{bool}{Detach}{\param{wxWindow* }{window}} | |
198 | ||
199 | \func{bool}{Detach}{\param{wxSizer* }{sizer}} | |
200 | ||
12a3f227 | 201 | \func{bool}{Detach}{\param{size\_t }{index}} |
00976fe5 | 202 | |
e3950b18 VZ |
203 | Detach a child from the sizer without destroying it. \arg{window} is the window to be |
204 | detached, \arg{sizer} is the equivalent sizer and \arg{index} is the position of | |
00976fe5 RL |
205 | the child in the sizer, typically 0 for the first item. This method does not |
206 | cause any layout or resizing to take place, call \helpref{wxSizer::Layout}{wxsizerlayout} | |
207 | to update the layout "on screen" after detaching a child from the sizer. | |
208 | ||
cc81d32f | 209 | Returns true if the child item was found and detached, false otherwise. |
00976fe5 RL |
210 | |
211 | \wxheading{See also} | |
212 | ||
213 | \helpref{wxSizer::Remove}{wxsizerremove} | |
214 | ||
02c6137e | 215 | |
f6bcfd97 BP |
216 | \membersection{wxSizer::Fit}\label{wxsizerfit} |
217 | ||
e5251d4f | 218 | \func{wxSize}{Fit}{\param{wxWindow* }{window}} |
f6bcfd97 | 219 | |
e3950b18 | 220 | Tell the sizer to resize the \arg{window} to match the sizer's minimal size. This |
f6bcfd97 | 221 | is commonly done in the constructor of the window itself, see sample in the description |
e5251d4f | 222 | of \helpref{wxBoxSizer}{wxboxsizer}. Returns the new size. |
f6bcfd97 | 223 | |
02c6137e VZ |
224 | For a top level window this is the total window size, not client size. |
225 | ||
226 | ||
566d84a7 RL |
227 | \membersection{wxSizer::FitInside}\label{wxsizerfitinside} |
228 | ||
229 | \func{void}{FitInside}{\param{wxWindow* }{window}} | |
230 | ||
e3950b18 | 231 | Tell the sizer to resize the virtual size of the \arg{window} to match the sizer's |
566d84a7 RL |
232 | minimal size. This will not alter the on screen size of the window, but may cause |
233 | the addition/removal/alteration of scrollbars required to view the virtual area in | |
234 | windows which manage it. | |
235 | ||
236 | \wxheading{See also} | |
237 | ||
238 | \helpref{wxScrolledWindow::SetScrollbars}{wxscrolledwindowsetscrollbars},\rtfsp | |
239 | \helpref{wxSizer::SetVirtualSizeHints}{wxsizersetvirtualsizehints} | |
240 | ||
02c6137e | 241 | |
e8cfff87 VZ |
242 | \membersection{wxSizer::GetContainingWindow}\label{wxsizergetcontainingwindow} |
243 | ||
244 | \constfunc{wxWindow *}{GetContainingWindow}{\void} | |
245 | ||
246 | Returns the window this sizer is used in or \NULL if none. | |
247 | ||
248 | ||
9f13661f WS |
249 | \membersection{wxSizer::GetItem}\label{wxsizergetitem} |
250 | ||
251 | \func{wxSizerItem *}{GetItem}{\param{wxWindow* }{window}, \param{bool }{recursive = false}} | |
252 | ||
253 | \func{wxSizerItem *}{GetItem}{\param{wxSizer* }{sizer}, \param{bool }{recursive = false}} | |
254 | ||
255 | \func{wxSizerItem *}{GetItem}{\param{size\_t }{index}} | |
256 | ||
e3950b18 VZ |
257 | Finds item of the sizer which holds given \arg{window}, \arg{sizer} or is located |
258 | in sizer at position \arg{index}. | |
259 | Use parameter \arg{recursive} to search in subsizers too. | |
9f13661f WS |
260 | |
261 | Returns pointer to item or NULL. | |
262 | ||
263 | ||
f6bcfd97 BP |
264 | \membersection{wxSizer::GetSize}\label{wxsizergetsize} |
265 | ||
266 | \func{wxSize}{GetSize}{\void} | |
267 | ||
268 | Returns the current size of the sizer. | |
269 | ||
02c6137e | 270 | |
f6bcfd97 BP |
271 | \membersection{wxSizer::GetPosition}\label{wxsizergetposition} |
272 | ||
273 | \func{wxPoint}{GetPosition}{\void} | |
274 | ||
275 | Returns the current position of the sizer. | |
276 | ||
02c6137e | 277 | |
f6bcfd97 BP |
278 | \membersection{wxSizer::GetMinSize}\label{wxsizergetminsize} |
279 | ||
280 | \func{wxSize}{GetMinSize}{\void} | |
281 | ||
282 | Returns the minimal size of the sizer. This is either the combined minimal | |
283 | size of all the children and their borders or the minimal size set by | |
284 | \helpref{SetMinSize}{wxsizersetminsize}, depending on which is bigger. | |
285 | ||
02c6137e | 286 | |
e3950b18 VZ |
287 | \membersection{wxSizer::Hide}\label{wxsizerhide} |
288 | ||
289 | \func{bool}{Hide}{\param{wxWindow* }{window}, \param{bool }{recursive = false}} | |
290 | ||
291 | \func{bool}{Hide}{\param{wxSizer* }{sizer}, \param{bool }{recursive = false}} | |
292 | ||
293 | \func{bool}{Hide}{\param{size\_t }{index}} | |
294 | ||
295 | Hides the \arg{window}, \arg{sizer}, or item at \arg{index}. | |
296 | To make a sizer item disappear, use Hide() followed by \helpref{Layout()}{wxsizerlayout}. | |
297 | Use parameter \arg{recursive} to hide elements found in subsizers. | |
298 | ||
299 | Returns \true if the child item was found, \false otherwise. | |
300 | ||
301 | \wxheading{See also} | |
302 | ||
303 | \helpref{wxSizer::IsShown}{wxsizerisshown},\rtfsp | |
304 | \helpref{wxSizer::Show}{wxsizershow} | |
305 | ||
306 | ||
00976fe5 RL |
307 | \membersection{wxSizer::Insert}\label{wxsizerinsert} |
308 | ||
40210d8a RN |
309 | \func{wxSizerItem*}{Insert}{\param{size\_t }{index}, \param{wxWindow* }{window}, \param{const wxSizerFlags\& }{flags}} |
310 | ||
56eee37f | 311 | \func{wxSizerItem*}{Insert}{\param{size\_t }{index}, \param{wxWindow* }{window}, \param{int }{proportion = 0},\param{int }{flag = 0}, \param{int }{border = 0}, \param{wxObject* }{userData = NULL}} |
00976fe5 | 312 | |
40210d8a RN |
313 | \func{wxSizerItem*}{Insert}{\param{size\_t }{index}, \param{wxSizer* }{sizer}, \param{const wxSizerFlags\& }{flags}} |
314 | ||
56eee37f | 315 | \func{wxSizerItem*}{Insert}{\param{size\_t }{index}, \param{wxSizer* }{sizer}, \param{int }{proportion = 0}, \param{int }{flag = 0}, \param{int }{border = 0}, \param{wxObject* }{userData = NULL}} |
00976fe5 | 316 | |
56eee37f | 317 | \func{wxSizerItem*}{Insert}{\param{size\_t }{index}, \param{int }{width}, \param{int }{height}, \param{int }{proportion = 0}, \param{int }{flag = 0}, \param{int }{border = 0}, \param{wxObject* }{userData = NULL}} |
00976fe5 | 318 | |
e3950b18 | 319 | Insert a child into the sizer before any existing item at \arg{index}. |
00976fe5 | 320 | |
12a3f227 | 321 | \docparam{index}{The position this child should assume in the sizer.} |
00976fe5 RL |
322 | |
323 | See \helpref{wxSizer::Add}{wxsizeradd} for the meaning of the other parameters. | |
324 | ||
02c6137e | 325 | |
749bb9f1 DS |
326 | \membersection{wxSizer::InsertSpacer}\label{wxsizerinsertspacer} |
327 | ||
56eee37f | 328 | \func{wxSizerItem*}{InsertSpacer}{\param{size\_t }{index}, \param{int }{size}} |
749bb9f1 DS |
329 | |
330 | Inserts non-stretchable space to the sizer. More readable way of calling | |
331 | \helpref{Insert}{wxsizerinsert}(size, size, 0). | |
332 | ||
333 | ||
334 | \membersection{wxSizer::InsertStretchSpacer}\label{wxsizerinsertstretchspacer} | |
335 | ||
56eee37f | 336 | \func{wxSizerItem*}{InsertStretchSpacer}{\param{size\_t }{index}, \param{int }{prop = 1}} |
749bb9f1 DS |
337 | |
338 | Inserts stretchable space to the sizer. More readable way of calling | |
339 | \helpref{Insert}{wxsizerinsert}(0, 0, prop). | |
340 | ||
341 | ||
e3950b18 VZ |
342 | \membersection{wxSizer::IsShown}\label{wxsizerisshown} |
343 | ||
344 | \constfunc{bool}{IsShown}{\param{wxWindow* }{window}} | |
345 | ||
346 | \constfunc{bool}{IsShown}{\param{wxSizer* }{sizer}} | |
347 | ||
348 | \constfunc{bool}{IsShown}{\param{size\_t }{index}} | |
349 | ||
350 | Returns \true if the \arg{window}, \arg{sizer}, or item at \arg{index} is shown. | |
351 | ||
352 | \wxheading{See also} | |
353 | ||
354 | \helpref{wxSizer::Hide}{wxsizerhide},\rtfsp | |
355 | \helpref{wxSizer::Show}{wxsizershow} | |
356 | ||
357 | ||
f6bcfd97 BP |
358 | \membersection{wxSizer::Layout}\label{wxsizerlayout} |
359 | ||
360 | \func{void}{Layout}{\void} | |
361 | ||
362 | Call this to force layout of the children anew, e.g. after having added a child | |
363 | to or removed a child (window, other sizer or space) from the sizer while keeping | |
364 | the current dimension. | |
76e1c2de | 365 | |
02c6137e | 366 | |
9c884972 | 367 | \membersection{wxSizer::Prepend}\label{wxsizerprepend} |
8fe05782 | 368 | |
40210d8a RN |
369 | \func{wxSizerItem*}{Prepend}{\param{wxWindow* }{window}, \param{const wxSizerFlags\& }{flags}} |
370 | ||
56eee37f | 371 | \func{wxSizerItem*}{Prepend}{\param{wxWindow* }{window}, \param{int }{proportion = 0}, \param{int }{flag = 0}, \param{int }{border = 0}, \param{wxObject* }{userData = NULL}} |
8fe05782 | 372 | |
40210d8a RN |
373 | \func{wxSizerItem*}{Prepend}{\param{wxSizer* }{sizer}, \param{const wxSizerFlags\& }{flags}} |
374 | ||
56eee37f | 375 | \func{wxSizerItem*}{Prepend}{\param{wxSizer* }{sizer}, \param{int }{proportion = 0}, \param{int }{flag = 0}, \param{int }{border = 0}, \param{wxObject* }{userData = NULL}} |
9c884972 | 376 | |
56eee37f | 377 | \func{wxSizerItem*}{Prepend}{\param{int }{width}, \param{int }{height}, \param{int }{proportion = 0}, \param{int }{flag = 0}, \param{int }{border= 0}, \param{wxObject* }{userData = NULL}} |
9c884972 RR |
378 | |
379 | Same as \helpref{wxSizer::Add}{wxsizeradd}, but prepends the items to the beginning of the | |
4130b487 | 380 | list of items (windows, subsizers or spaces) owned by this sizer. |
8fe05782 | 381 | |
02c6137e | 382 | |
749bb9f1 DS |
383 | \membersection{wxSizer::PrependSpacer}\label{wxsizerprependspacer} |
384 | ||
56eee37f | 385 | \func{wxSizerItem*}{PrependSpacer}{\param{int }{size}} |
749bb9f1 DS |
386 | |
387 | Prepends non-stretchable space to the sizer. More readable way of calling | |
388 | \helpref{Prepend}{wxsizerprepend}(size, size, 0). | |
389 | ||
390 | ||
391 | \membersection{wxSizer::PrependStretchSpacer}\label{wxsizerprependstretchspacer} | |
392 | ||
56eee37f | 393 | \func{wxSizerItem*}{PrependStretchSpacer}{\param{int }{prop = 1}} |
749bb9f1 DS |
394 | |
395 | Prepends stretchable space to the sizer. More readable way of calling | |
396 | \helpref{Prepend}{wxsizerprepend}(0, 0, prop). | |
397 | ||
398 | ||
f6bcfd97 BP |
399 | \membersection{wxSizer::RecalcSizes}\label{wxsizerrecalcsizes} |
400 | ||
401 | \func{void}{RecalcSizes}{\void} | |
402 | ||
403 | This method is abstract and has to be overwritten by any derived class. | |
404 | Here, the sizer will do the actual calculation of its children's positions | |
405 | and sizes. | |
406 | ||
02c6137e | 407 | |
9c884972 RR |
408 | \membersection{wxSizer::Remove}\label{wxsizerremove} |
409 | ||
410 | \func{bool}{Remove}{\param{wxWindow* }{window}} | |
411 | ||
412 | \func{bool}{Remove}{\param{wxSizer* }{sizer}} | |
413 | ||
12a3f227 | 414 | \func{bool}{Remove}{\param{size\_t }{index}} |
9c884972 | 415 | |
8258c3dd VZ |
416 | Removes a child from the sizer and destroys it if it is a sizer or a spacer, |
417 | but not if it is a window (because windows are owned by their parent window, | |
418 | not the sizer). \arg{sizer} is the wxSizer to be removed, | |
419 | \arg{index} is the position of the child in the sizer, e.g. $0$ for the first item. | |
12a3f227 | 420 | This method does not cause any layout or resizing to take place, call |
00976fe5 RL |
421 | \helpref{wxSizer::Layout}{wxsizerlayout} to update the layout "on screen" after removing a |
422 | child from the sizer. | |
423 | ||
8258c3dd VZ |
424 | {\bf NB:} The method taking a wxWindow* parameter is deprecated as it does not |
425 | destroy the window as would usually be expected from Remove. You should use | |
426 | \helpref{wxSizer::Detach}{wxsizerdetach} in new code instead. There is | |
427 | currently no wxSizer method that will both detach and destroy a wxWindow item. | |
9c884972 | 428 | |
cc81d32f | 429 | Returns true if the child item was found and removed, false otherwise. |
8fe05782 | 430 | |
02c6137e | 431 | |
eae0338f RR |
432 | \membersection{wxSizer::Replace}\label{wxsizerreplace} |
433 | ||
434 | \func{bool}{Replace}{\param{wxWindow* }{oldwin}, \param{wxWindow* }{newwin}, \param{bool }{recursive = false}} | |
435 | ||
436 | \func{bool}{Replace}{\param{wxSizer* }{oldsz}, \param{wxSizer* }{newsz}, \param{bool }{recursive = false}} | |
437 | ||
438 | \func{bool}{Remove}{\param{size\_t }{oldindex}, \param{wxSizerItem* }{newitem}} | |
439 | ||
440 | Detaches the given \arg{oldwin}, \arg{oldsz} child from the sizer and | |
441 | replaces it with the given window, sizer, or wxSizerItem. | |
442 | ||
443 | The detached child is removed {\bf only} if it is a sizer or a spacer | |
444 | (because windows are owned by their parent window, not the sizer). | |
445 | ||
446 | Use parameter \arg{recursive} to search the given element recursively in subsizers. | |
447 | ||
448 | ||
449 | This method does not cause any layout or resizing to take place, call | |
450 | \helpref{wxSizer::Layout}{wxsizerlayout} to update the layout "on screen" after replacing a | |
451 | child from the sizer. | |
452 | ||
453 | Returns true if the child item was found and removed, false otherwise. | |
454 | ||
455 | ||
8fe05782 VZ |
456 | \membersection{wxSizer::SetDimension}\label{wxsizersetdimension} |
457 | ||
458 | \func{void}{SetDimension}{\param{int }{x}, \param{int }{y}, \param{int }{width}, \param{int }{height}} | |
459 | ||
9c884972 | 460 | Call this to force the sizer to take the given dimension and thus force the items owned |
2edb0bde | 461 | by the sizer to resize themselves according to the rules defined by the parameter in the |
f6bcfd97 | 462 | \helpref{Add}{wxsizeradd} and \helpref{Prepend}{wxsizerprepend} methods. |
8fe05782 | 463 | |
02c6137e | 464 | |
f6bcfd97 | 465 | \membersection{wxSizer::SetMinSize}\label{wxsizersetminsize} |
8fe05782 | 466 | |
f6bcfd97 | 467 | \func{void}{SetMinSize}{\param{int }{width}, \param{int }{height}} |
8fe05782 | 468 | |
fbfb8bcc | 469 | \func{void}{SetMinSize}{\param{const wxSize\& }{size}} |
8fe05782 | 470 | |
f6bcfd97 BP |
471 | Call this to give the sizer a minimal size. Normally, the sizer will calculate its |
472 | minimal size based purely on how much space its children need. After calling this | |
473 | method \helpref{GetMinSize}{wxsizergetminsize} will return either the minimal size | |
474 | as requested by its children or the minimal size set here, depending on which is | |
475 | bigger. | |
8fe05782 | 476 | |
02c6137e | 477 | |
f6bcfd97 | 478 | \membersection{wxSizer::SetItemMinSize}\label{wxsizersetitemminsize} |
8fe05782 | 479 | |
f6bcfd97 | 480 | \func{void}{SetItemMinSize}{\param{wxWindow* }{window}, \param{int}{ width}, \param{int}{ height}} |
8fe05782 | 481 | |
f6bcfd97 | 482 | \func{void}{SetItemMinSize}{\param{wxSizer* }{sizer}, \param{int}{ width}, \param{int}{ height}} |
8fe05782 | 483 | |
12a3f227 | 484 | \func{void}{SetItemMinSize}{\param{size\_t }{index}, \param{int}{ width}, \param{int}{ height}} |
8fe05782 | 485 | |
f6bcfd97 BP |
486 | Set an item's minimum size by window, sizer, or position. The item will be found recursively |
487 | in the sizer's descendants. This function enables an application to set the size of an item | |
488 | after initial creation. | |
8fe05782 | 489 | |
02c6137e | 490 | |
8fe05782 VZ |
491 | \membersection{wxSizer::SetSizeHints}\label{wxsizersetsizehints} |
492 | ||
493 | \func{void}{SetSizeHints}{\param{wxWindow* }{window}} | |
494 | ||
e3950b18 | 495 | Tell the sizer to set (and \helpref{Fit}{wxsizerfit}) the minimal size of the \arg{window} to |
566d84a7 RL |
496 | match the sizer's minimal size. This is commonly done in the constructor of the window itself, |
497 | see sample in the description of \helpref{wxBoxSizer}{wxboxsizer} if the window is resizable | |
498 | (as are many dialogs under Unix and frames on probably all platforms). | |
499 | ||
02c6137e | 500 | |
566d84a7 RL |
501 | \membersection{wxSizer::SetVirtualSizeHints}\label{wxsizersetvirtualsizehints} |
502 | ||
503 | \func{void}{SetVirtualSizeHints}{\param{wxWindow* }{window}} | |
504 | ||
e3950b18 | 505 | Tell the sizer to set the minimal size of the \arg{window} virtual area to match the sizer's |
2b5f62a0 | 506 | minimal size. For windows with managed scrollbars this will set them appropriately. |
566d84a7 RL |
507 | |
508 | \wxheading{See also} | |
509 | ||
510 | \helpref{wxScrolledWindow::SetScrollbars}{wxscrolledwindowsetscrollbars} | |
7e9a386e | 511 | |
02c6137e | 512 | |
2b5f62a0 VZ |
513 | \membersection{wxSizer::Show}\label{wxsizershow} |
514 | ||
8b2bac62 | 515 | \func{bool}{Show}{\param{wxWindow* }{window}, \param{bool }{show = true}, \param{bool }{recursive = false}} |
2b5f62a0 | 516 | |
8b2bac62 | 517 | \func{bool}{Show}{\param{wxSizer* }{sizer}, \param{bool }{show = true}, \param{bool }{recursive = false}} |
2b5f62a0 | 518 | |
8b2bac62 | 519 | \func{bool}{Show}{\param{size\_t }{index}, \param{bool }{show = true}} |
12a3f227 | 520 | |
e3950b18 VZ |
521 | Shows or hides the \arg{window}, \arg{sizer}, or item at \arg{index}. |
522 | To make a sizer item disappear or reappear, use Show() followed by \helpref{Layout()}{wxsizerlayout}. | |
523 | Use parameter \arg{recursive} to show or hide elements found in subsizers. | |
8b2bac62 WS |
524 | |
525 | Returns true if the child item was found, false otherwise. | |
2b5f62a0 | 526 | |
e3950b18 VZ |
527 | \wxheading{See also} |
528 | ||
529 | \helpref{wxSizer::Hide}{wxsizerhide},\rtfsp | |
530 | \helpref{wxSizer::IsShown}{wxsizerisshown} | |
0497e172 | 531 | |
2a3c8b65 RN |
532 | |
533 | ||
534 | ||
535 | \section{\class{wxSizerFlags}}\label{wxsizerflags} | |
536 | ||
62637495 VZ |
537 | Normally, when you add an item to a sizer via |
538 | \helpref{wxSizer::Add}{wxsizeradd}, you have to specify a lot of flags and | |
539 | parameters which can be unwieldy. This is where wxSizerFlags comes in: it | |
540 | allows you to specify all parameters using the named methods instead. For | |
541 | example, instead of | |
40210d8a | 542 | |
62637495 VZ |
543 | \begin{verbatim} |
544 | sizer->Add(ctrl, 0, wxEXPAND | wxBORDER, 10); | |
545 | \end{verbatim} | |
2a3c8b65 | 546 | |
62637495 | 547 | you can now write |
2a3c8b65 | 548 | |
62637495 VZ |
549 | \begin{verbatim} |
550 | sizer->Add(ctrl, wxSizerFlags().Expand().Border(10)); | |
551 | \end{verbatim} | |
552 | ||
553 | This is more readable and also allows you to create wxSizerFlags objects which | |
554 | can be reused for several sizer items. | |
555 | \begin{verbatim} | |
556 | wxSizerFlags flagsExpand(1); | |
557 | flagsExpand.Expand().Border(10); | |
558 | ||
559 | sizer->Add(ctrl1, flagsExpand); | |
560 | sizer->Add(ctrl2, flagsExpand); | |
561 | \end{verbatim} | |
562 | ||
563 | Note that by specification, all methods of wxSizerFlags return the wxSizerFlags | |
564 | object itself to allowing chaining multiple methods calls like in the examples | |
565 | above. | |
2a3c8b65 | 566 | |
f2fe4f67 | 567 | |
9a75ba66 | 568 | \membersection{wxSizerFlags::wxSizerFlags}\label{wxsizerflagsctor} |
2a3c8b65 RN |
569 | |
570 | \func{}{wxSizerFlags}{\param{int }{proportion = 0}} | |
571 | ||
2be7beda | 572 | Creates the wxSizer with the proportion specified by \arg{proportion}. |
2a3c8b65 RN |
573 | |
574 | ||
f2fe4f67 | 575 | \membersection{wxSizerFlags::Align}\label{wxsizerflagsalign} |
2a3c8b65 RN |
576 | |
577 | \func{wxSizerFlags\& }{Align}{\param{int }{align = 0}} | |
578 | ||
2be7beda | 579 | Sets the alignment of this wxSizerFlags to \arg{align}. |
2a3c8b65 RN |
580 | |
581 | Note that if this method is not called, the wxSizerFlags has no specified alignment. | |
582 | ||
e72ac082 VZ |
583 | \wxheading{See also} |
584 | ||
585 | \helpref{Left}{wxsizerflagsleft},\\ | |
586 | \helpref{Right}{wxsizerflagsright},\\ | |
587 | \helpref{Centre}{wxsizerflagscentre} | |
588 | ||
2a3c8b65 | 589 | |
f2fe4f67 | 590 | \membersection{wxSizerFlags::Border}\label{wxsizerflagsborder} |
2a3c8b65 RN |
591 | |
592 | \func{wxSizerFlags\& }{Border}{\param{int }{direction}, \param{int }{borderinpixels}} | |
593 | ||
2a3c8b65 RN |
594 | \func{wxSizerFlags\& }{Border}{\param{int }{direction = wxALL}} |
595 | ||
2be7beda VZ |
596 | Sets the wxSizerFlags to have a border of a number of pixels specified by |
597 | \arg{borderinpixels} with the directions specified by \arg{direction}. | |
598 | ||
599 | In the overloaded version without \arg{borderinpixels} parameter, the border of | |
600 | default size, as returned by \helpref{GetDefaultBorder}{wxsizerflagsgetdefaultborder}, | |
601 | is used. | |
2a3c8b65 RN |
602 | |
603 | ||
f2fe4f67 | 604 | \membersection{wxSizerFlags::Center}\label{wxsizerflagscenter} |
2a3c8b65 RN |
605 | |
606 | \func{wxSizerFlags\& }{Center}{\void} | |
607 | ||
608 | Sets the object of the wxSizerFlags to center itself in the area it is given. | |
609 | ||
610 | ||
f2fe4f67 | 611 | \membersection{wxSizerFlags::Centre}\label{wxsizerflagscentre} |
2a3c8b65 RN |
612 | |
613 | \func{wxSizerFlags\& }{Centre}{\void} | |
614 | ||
615 | \helpref{wxSizerFlags::Center}{wxsizerflagscenter} for people with the other dialect of english. | |
616 | ||
617 | ||
25eb10d2 VZ |
618 | \membersection{wxSizerFlags::DoubleBorder}\label{wxsizerflagsdoubleborder} |
619 | ||
620 | \func{wxSizerFlags\& }{DoubleBorder}{\param{int }{direction = wxALL}} | |
621 | ||
622 | Sets the border in the given \arg{direction} having twice the default border | |
623 | size. | |
624 | ||
625 | ||
626 | \membersection{wxSizerFlags::DoubleHorzBorder}\label{wxsizerflagsdoublehorzborder} | |
627 | ||
628 | \func{wxSizerFlags\& }{DoubleHorzBorder}{\void} | |
629 | ||
630 | Sets the border in left and right directions having twice the default border | |
631 | size. | |
632 | ||
633 | ||
f2fe4f67 | 634 | \membersection{wxSizerFlags::Expand}\label{wxsizerflagsexpand} |
2a3c8b65 | 635 | |
0f353563 | 636 | \func{wxSizerFlags\& }{Expand}{\void} |
2a3c8b65 RN |
637 | |
638 | Sets the object of the wxSizerFlags to expand to fill as much area as it can. | |
639 | ||
640 | ||
2be7beda VZ |
641 | \membersection{wxSizerFlags::GetDefaultBorder}\label{wxsizerflagsgetdefaultborder} |
642 | ||
643 | \func{static int}{GetDefaultBorder}{\void} | |
644 | ||
645 | Returns the border used by default in \helpref{Border}{wxsizerflagsborder} method. | |
646 | ||
647 | ||
e72ac082 VZ |
648 | \membersection{wxSizerFlags::Left}\label{wxsizerflagsleft} |
649 | ||
650 | \func{wxSizerFlags\& }{Left}{\void} | |
651 | ||
652 | Aligns the object to the left, shortcut for \texttt{Align(wxALIGN\_LEFT)} | |
653 | ||
654 | \wxheading{See also} | |
655 | ||
656 | \helpref{Align}{wxsizerflagsalign} | |
657 | ||
658 | ||
f2fe4f67 | 659 | \membersection{wxSizerFlags::Proportion}\label{wxsizerflagsproportion} |
2a3c8b65 RN |
660 | |
661 | \func{wxSizerFlags\& }{Proportion}{\param{int }{proportion = 0}} | |
662 | ||
2be7beda | 663 | Sets the proportion of this wxSizerFlags to \arg{proportion} |
2a3c8b65 RN |
664 | |
665 | ||
e72ac082 VZ |
666 | \membersection{wxSizerFlags::Right}\label{wxsizerflagsright} |
667 | ||
668 | \func{wxSizerFlags\& }{Right}{\void} | |
669 | ||
670 | Aligns the object to the right, shortcut for \texttt{Align(wxALIGN\_RIGHT)} | |
671 | ||
672 | \wxheading{See also} | |
673 | ||
674 | \helpref{Align}{wxsizerflagsalign} | |
2a3c8b65 | 675 | |
25eb10d2 VZ |
676 | |
677 | \membersection{wxSizerFlags::TripleBorder}\label{wxsizerflagstriplebleborder} | |
678 | ||
679 | \func{wxSizerFlags\& }{TripleBorder}{\param{int }{direction = wxALL}} | |
680 | ||
681 | Sets the border in the given \arg{direction} having thrice the default border | |
682 | size. | |
683 | ||
684 |