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