git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@43066 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
		
			
				
	
	
		
			699 lines
		
	
	
		
			26 KiB
		
	
	
	
		
			TeX
		
	
	
	
	
	
			
		
		
	
	
			699 lines
		
	
	
		
			26 KiB
		
	
	
	
		
			TeX
		
	
	
	
	
	
| \section{\class{wxSizer}}\label{wxsizer}
 | |
| 
 | |
| wxSizer is the abstract base class used for laying out subwindows in a window. You
 | |
| cannot use wxSizer directly; instead, you will have to use one of the sizer
 | |
| classes derived from it. Currently there are \helpref{wxBoxSizer}{wxboxsizer}, 
 | |
| \helpref{wxStaticBoxSizer}{wxstaticboxsizer},
 | |
| \helpref{wxGridSizer}{wxgridsizer} 
 | |
| \helpref{wxFlexGridSizer}{wxflexgridsizer} and \helpref{wxGridBagSizer}{wxgridbagsizer}.
 | |
| 
 | |
| The layout algorithm used by sizers in wxWidgets is closely related to layout
 | |
| in other GUI toolkits, such as Java's AWT, the GTK toolkit or the Qt toolkit. It is
 | |
| based upon the idea of the individual subwindows reporting their minimal required
 | |
| size and their ability to get stretched if the size of the parent window has changed.
 | |
| This will most often mean that the programmer does not set the original size of
 | |
| a dialog in the beginning, rather the dialog will be assigned a sizer and this sizer
 | |
| will be queried about the recommended size. The sizer in turn will query its
 | |
| children, which can be normal windows, empty space or other sizers, so that
 | |
| a hierarchy of sizers can be constructed. Note that wxSizer does not derive from wxWindow
 | |
| and thus does not interfere with tab ordering and requires very little resources compared
 | |
| to a real window on screen.
 | |
| 
 | |
| What makes sizers so well fitted for use in wxWidgets is the fact that every control
 | |
| reports its own minimal size and the algorithm can handle differences in font sizes
 | |
| or different window (dialog item) sizes on different platforms without problems. If e.g.
 | |
| the standard font as well as the overall design of Motif widgets requires more space than
 | |
| on Windows, the initial dialog size will automatically be bigger on Motif than on Windows.
 | |
| 
 | |
| Sizers may also be used to control the layout of custom drawn items on the window.  The
 | |
| Add, Insert, and Prepend functions return a pointer to the newly added wxSizerItem. Just
 | |
| add empty space of the desired size and attributes, and then use the wxSizerItem::GetRect
 | |
| method to determine where the drawing operations should take place.
 | |
| 
 | |
| 
 | |
| Please notice that sizers, like child windows, are owned by the library and
 | |
| will be deleted by it which implies that they must be allocated on the heap.
 | |
| However if you create a sizer and do not add it to another sizer or window, the
 | |
| library wouldn't be able to delete such an orphan sizer and in this, and only
 | |
| this, case it should be deleted explicitly.
 | |
| 
 | |
| \pythonnote{If you wish to create a sizer class in wxPython you should
 | |
| derive the class from {\tt wxPySizer} in order to get Python-aware
 | |
| capabilities for the various virtual methods.}
 | |
| 
 | |
| \wxheading{Derived from}
 | |
| 
 | |
| \helpref{wxObject}{wxobject}\\
 | |
| \helpref{wxClientDataContainer}{wxclientdatacontainer}
 | |
| 
 | |
| \wxheading{Include files}
 | |
| 
 | |
| <wx/sizer.h>
 | |
| 
 | |
| \wxheading{See also}
 | |
| 
 | |
| \helpref{Sizer overview}{sizeroverview}
 | |
| 
 | |
| \latexignore{\rtfignore{\wxheading{Members}}}
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::wxSizer}\label{wxsizerwxsizer}
 | |
| 
 | |
| \func{}{wxSizer}{\void}
 | |
| 
 | |
| The constructor. Note that wxSizer is an abstract base class and may not
 | |
| be instantiated.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::\destruct{wxSizer}}\label{wxsizerdtor}
 | |
| 
 | |
| \func{}{\destruct{wxSizer}}{\void}
 | |
| 
 | |
| The destructor.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::Add}\label{wxsizeradd}
 | |
| 
 | |
| \func{wxSizerItem*}{Add}{\param{wxWindow* }{window}, \param{const wxSizerFlags\& }{flags}}
 | |
| 
 | |
| \func{wxSizerItem*}{Add}{\param{wxWindow* }{window}, \param{int }{proportion = 0},\param{int }{flag = 0}, \param{int }{border = 0}, \param{wxObject* }{userData = NULL}}
 | |
| 
 | |
| \func{wxSizerItem*}{Add}{\param{wxSizer* }{sizer}, \param{const wxSizerFlags\& }{flags}}
 | |
| 
 | |
| \func{wxSizerItem*}{Add}{\param{wxSizer* }{sizer}, \param{int }{proportion = 0}, \param{int }{flag = 0}, \param{int }{border = 0}, \param{wxObject* }{userData = NULL}}
 | |
| 
 | |
| \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}}
 | |
| 
 | |
| Appends a child to the sizer.  wxSizer itself is an abstract class, but the parameters are
 | |
| equivalent in the derived classes that you will instantiate to use it so they are described
 | |
| here:
 | |
| 
 | |
| \docparam{window}{The window to be added to the sizer. Its initial size (either set explicitly by the
 | |
| user or calculated internally when using wxDefaultSize) is interpreted as the minimal and in many
 | |
| cases also the initial size.}
 | |
| 
 | |
| \docparam{sizer}{The (child-)sizer to be added to the sizer. This allows placing a child sizer in a
 | |
| sizer and thus to create hierarchies of sizers (typically a vertical box as the top sizer and several
 | |
| horizontal boxes on the level beneath).}
 | |
| 
 | |
| \docparam{width and height}{The dimension of a spacer to be added to the sizer. Adding spacers to sizers
 | |
| gives more flexibility in the design of dialogs; imagine for example a horizontal box with two buttons at the
 | |
| bottom of a dialog: you might want to insert a space between the two buttons and make that space stretchable
 | |
| using the \arg{proportion} flag and the result will be that the left button will be aligned with the left
 | |
| side of the dialog and the right button with the right side - the space in between will shrink and grow with
 | |
| the dialog.}
 | |
| 
 | |
| \docparam{proportion}{Although the meaning of this parameter is undefined in wxSizer, it is used in wxBoxSizer
 | |
| to indicate if a child of a sizer can change its size in the main orientation of the wxBoxSizer - where
 | |
| 0 stands for not changeable and a value of more than zero is interpreted relative to the value of other
 | |
| children of the same wxBoxSizer. For example, you might have a horizontal wxBoxSizer with three children, two
 | |
| of which are supposed to change their size with the sizer. Then the two stretchable windows would get a
 | |
| value of 1 each to make them grow and shrink equally with the sizer's horizontal dimension.}
 | |
| 
 | |
| \docparam{flag}{This parameter can be used to set a number of flags
 | |
| which can be combined using the binary OR operator |. Two main
 | |
| behaviours are defined using these flags. One is the border around a
 | |
| window: the \arg{border} parameter determines the border width whereas
 | |
| the flags given here determine which side(s) of the item that the
 | |
| border will be added.  The other flags determine how the sizer item
 | |
| behaves when the space allotted to the sizer changes, and is somewhat
 | |
| dependent on the specific kind of sizer used.
 | |
| 
 | |
| \twocolwidtha{5cm}%
 | |
| \begin{twocollist}\itemsep=0pt
 | |
| \twocolitem{\windowstyle{wxTOP}\\
 | |
| \windowstyle{wxBOTTOM}\\
 | |
| \windowstyle{wxLEFT}\\
 | |
| \windowstyle{wxRIGHT}\\
 | |
| \windowstyle{wxALL}}{These flags are used to specify which side(s) of
 | |
|   the sizer item the \arg{border} width will apply to. }
 | |
| 
 | |
| \twocolitem{\windowstyle{wxEXPAND}}{The item will be expanded to fill
 | |
| the space assigned to the item.}
 | |
| \twocolitem{\windowstyle{wxSHAPED}}{The item will be expanded as much
 | |
| as possible while also maintaining its aspect ratio}
 | |
| \twocolitem{\windowstyle{wxFIXED\_MINSIZE}}{Normally wxSizers will use 
 | |
| \helpref{GetAdjustedBestSize}{wxwindowgetadjustedbestsize} to
 | |
| determine what the minimal size of window items should be, and will
 | |
| use that size to calculate the layout. This allows layouts to
 | |
| adjust when an item changes and its \arg{best size} becomes
 | |
| different. If you would rather have a window item stay the size it
 | |
| started with then use wxFIXED\_MINSIZE.}
 | |
| \twocolitem{\windowstyle{wxALIGN\_CENTER wxALIGN\_CENTRE}\\
 | |
| \windowstyle{wxALIGN\_LEFT}\\
 | |
| \windowstyle{wxALIGN\_RIGHT}\\
 | |
| \windowstyle{wxALIGN\_TOP}\\
 | |
| \windowstyle{wxALIGN\_BOTTOM}\\
 | |
| \windowstyle{wxALIGN\_CENTER\_VERTICAL wxALIGN\_CENTRE\_VERTICAL}\\
 | |
| \windowstyle{wxALIGN\_CENTER\_HORIZONTAL wxALIGN\_CENTRE\_HORIZONTAL}}{The wxALIGN flags allow you to
 | |
| specify the alignment of the item within the space allotted to it by
 | |
| the sizer, adjusted for the border if any.}
 | |
| \end{twocollist}
 | |
| }
 | |
| 
 | |
| \docparam{border}{Determines the border width, if the \arg{flag}
 | |
|   parameter is set to include any border flag.}
 | |
| 
 | |
| \docparam{userData}{Allows an extra object to be attached to the sizer
 | |
| item, for use in derived classes when sizing information is more
 | |
| complex than the \arg{proportion} and \arg{flag} will allow for.}
 | |
| 
 | |
| \docparam{flags}{A \helpref{wxSizerFlags}{wxsizerflags} object that 
 | |
| enables you to specify most of the above parameters more conveniently.}
 | |
| 
 | |
| \membersection{wxSizer::AddSpacer}\label{wxsizeraddspacer}
 | |
| 
 | |
| \func{wxSizerItem*}{AddSpacer}{\param{int }{size}}
 | |
| 
 | |
| Adds non-stretchable space to the sizer. More readable way of calling
 | |
| \helpref{Add}{wxsizeradd}(size, size, 0).
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::AddStretchSpacer}\label{wxsizeraddstretchspacer}
 | |
| 
 | |
| \func{wxSizerItem*}{AddStretchSpacer}{\param{int }{prop = 1}}
 | |
| 
 | |
| Adds stretchable space to the sizer. More readable way of calling
 | |
| \helpref{Add}{wxsizeradd}(0, 0, prop).
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::CalcMin}\label{wxsizercalcmin}
 | |
| 
 | |
| \func{wxSize}{CalcMin}{\void}
 | |
| 
 | |
| This method is abstract and has to be overwritten by any derived class.
 | |
| Here, the sizer will do the actual calculation of its children minimal sizes.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::Clear}\label{wxsizerclear}
 | |
| 
 | |
| \func{void}{Clear}{\param{bool }{delete\_windows = false}}
 | |
| 
 | |
| Detaches all children from the sizer. If \arg{delete\_windows} is \true then child windows will also be deleted.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::Detach}\label{wxsizerdetach}
 | |
| 
 | |
| \func{bool}{Detach}{\param{wxWindow* }{window}}
 | |
| 
 | |
| \func{bool}{Detach}{\param{wxSizer* }{sizer}}
 | |
| 
 | |
| \func{bool}{Detach}{\param{size\_t }{index}}
 | |
| 
 | |
| Detach a child from the sizer without destroying it. \arg{window} is the window to be
 | |
| detached, \arg{sizer} is the equivalent sizer and \arg{index} is the position of
 | |
| the child in the sizer, typically 0 for the first item. This method does not
 | |
| cause any layout or resizing to take place, call \helpref{wxSizer::Layout}{wxsizerlayout}
 | |
| to update the layout "on screen" after detaching a child from the sizer.
 | |
| 
 | |
| Returns true if the child item was found and detached, false otherwise.
 | |
| 
 | |
| \wxheading{See also}
 | |
| 
 | |
| \helpref{wxSizer::Remove}{wxsizerremove}
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::Fit}\label{wxsizerfit}
 | |
| 
 | |
| \func{wxSize}{Fit}{\param{wxWindow* }{window}}
 | |
| 
 | |
| Tell the sizer to resize the \arg{window} to match the sizer's minimal size. This
 | |
| is commonly done in the constructor of the window itself, see sample in the description
 | |
| of \helpref{wxBoxSizer}{wxboxsizer}. Returns the new size.
 | |
| 
 | |
| For a top level window this is the total window size, not client size.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::FitInside}\label{wxsizerfitinside}
 | |
| 
 | |
| \func{void}{FitInside}{\param{wxWindow* }{window}}
 | |
| 
 | |
| Tell the sizer to resize the virtual size of the \arg{window} to match the sizer's
 | |
| minimal size.  This will not alter the on screen size of the window, but may cause
 | |
| the addition/removal/alteration of scrollbars required to view the virtual area in
 | |
| windows which manage it.
 | |
| 
 | |
| \wxheading{See also}
 | |
| 
 | |
| \helpref{wxScrolledWindow::SetScrollbars}{wxscrolledwindowsetscrollbars},\rtfsp
 | |
| \helpref{wxSizer::SetVirtualSizeHints}{wxsizersetvirtualsizehints}
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::GetChildren}\label{wxsizergetchildren}
 | |
| 
 | |
| \func{wxSizerItemList\&}{GetChildren}{\void}
 | |
| 
 | |
| Returns the list of the items in this sizer. The elements of type-safe 
 | |
| \helpref{wxList}{wxlist} \texttt{wxSizerItemList} are objects of type 
 | |
| \helpref{wxSizerItem *}{wxsizeritem}.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::GetContainingWindow}\label{wxsizergetcontainingwindow}
 | |
| 
 | |
| \constfunc{wxWindow *}{GetContainingWindow}{\void}
 | |
| 
 | |
| Returns the window this sizer is used in or \NULL if none.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::GetItem}\label{wxsizergetitem}
 | |
| 
 | |
| \func{wxSizerItem *}{GetItem}{\param{wxWindow* }{window}, \param{bool }{recursive = false}}
 | |
| 
 | |
| \func{wxSizerItem *}{GetItem}{\param{wxSizer* }{sizer}, \param{bool }{recursive = false}}
 | |
| 
 | |
| \func{wxSizerItem *}{GetItem}{\param{size\_t }{index}}
 | |
| 
 | |
| Finds item of the sizer which holds given \arg{window}, \arg{sizer} or is located
 | |
| in sizer at position \arg{index}.
 | |
| Use parameter \arg{recursive} to search in subsizers too.
 | |
| 
 | |
| Returns pointer to item or NULL.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::GetSize}\label{wxsizergetsize}
 | |
| 
 | |
| \func{wxSize}{GetSize}{\void}
 | |
| 
 | |
| Returns the current size of the sizer.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::GetPosition}\label{wxsizergetposition}
 | |
| 
 | |
| \func{wxPoint}{GetPosition}{\void}
 | |
| 
 | |
| Returns the current position of the sizer.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::GetMinSize}\label{wxsizergetminsize}
 | |
| 
 | |
| \func{wxSize}{GetMinSize}{\void}
 | |
| 
 | |
| Returns the minimal size of the sizer. This is either the combined minimal
 | |
| size of all the children and their borders or the minimal size set by 
 | |
| \helpref{SetMinSize}{wxsizersetminsize}, depending on which is bigger.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::Hide}\label{wxsizerhide}
 | |
| 
 | |
| \func{bool}{Hide}{\param{wxWindow* }{window}, \param{bool }{recursive = false}}
 | |
| 
 | |
| \func{bool}{Hide}{\param{wxSizer* }{sizer}, \param{bool }{recursive = false}}
 | |
| 
 | |
| \func{bool}{Hide}{\param{size\_t }{index}}
 | |
| 
 | |
| Hides the \arg{window}, \arg{sizer}, or item at \arg{index}.
 | |
| To make a sizer item disappear, use Hide() followed by \helpref{Layout()}{wxsizerlayout}.
 | |
| Use parameter \arg{recursive} to hide elements found in subsizers.
 | |
| 
 | |
| Returns \true if the child item was found, \false otherwise.
 | |
| 
 | |
| \wxheading{See also}
 | |
| 
 | |
| \helpref{wxSizer::IsShown}{wxsizerisshown},\rtfsp
 | |
| \helpref{wxSizer::Show}{wxsizershow}
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::Insert}\label{wxsizerinsert}
 | |
| 
 | |
| \func{wxSizerItem*}{Insert}{\param{size\_t }{index}, \param{wxWindow* }{window}, \param{const wxSizerFlags\& }{flags}}
 | |
| 
 | |
| \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}}
 | |
| 
 | |
| \func{wxSizerItem*}{Insert}{\param{size\_t }{index}, \param{wxSizer* }{sizer}, \param{const wxSizerFlags\& }{flags}}
 | |
| 
 | |
| \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}}
 | |
| 
 | |
| \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}}
 | |
| 
 | |
| Insert a child into the sizer before any existing item at \arg{index}.
 | |
| 
 | |
| \docparam{index}{The position this child should assume in the sizer.}
 | |
| 
 | |
| See \helpref{wxSizer::Add}{wxsizeradd} for the meaning of the other parameters.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::InsertSpacer}\label{wxsizerinsertspacer}
 | |
| 
 | |
| \func{wxSizerItem*}{InsertSpacer}{\param{size\_t }{index}, \param{int }{size}}
 | |
| 
 | |
| Inserts non-stretchable space to the sizer. More readable way of calling
 | |
| \helpref{Insert}{wxsizerinsert}(size, size, 0).
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::InsertStretchSpacer}\label{wxsizerinsertstretchspacer}
 | |
| 
 | |
| \func{wxSizerItem*}{InsertStretchSpacer}{\param{size\_t }{index}, \param{int }{prop = 1}}
 | |
| 
 | |
| Inserts stretchable space to the sizer. More readable way of calling
 | |
| \helpref{Insert}{wxsizerinsert}(0, 0, prop).
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::IsShown}\label{wxsizerisshown}
 | |
| 
 | |
| \constfunc{bool}{IsShown}{\param{wxWindow* }{window}}
 | |
| 
 | |
| \constfunc{bool}{IsShown}{\param{wxSizer* }{sizer}}
 | |
| 
 | |
| \constfunc{bool}{IsShown}{\param{size\_t }{index}}
 | |
| 
 | |
| Returns \true if the \arg{window}, \arg{sizer}, or item at \arg{index} is shown.
 | |
| 
 | |
| \wxheading{See also}
 | |
| 
 | |
| \helpref{wxSizer::Hide}{wxsizerhide},\rtfsp
 | |
| \helpref{wxSizer::Show}{wxsizershow}
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::Layout}\label{wxsizerlayout}
 | |
| 
 | |
| \func{void}{Layout}{\void}
 | |
| 
 | |
| Call this to force layout of the children anew, e.g. after having added a child
 | |
| to or removed a child (window, other sizer or space) from the sizer while keeping
 | |
| the current dimension.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::Prepend}\label{wxsizerprepend}
 | |
| 
 | |
| \func{wxSizerItem*}{Prepend}{\param{wxWindow* }{window}, \param{const wxSizerFlags\& }{flags}}
 | |
| 
 | |
| \func{wxSizerItem*}{Prepend}{\param{wxWindow* }{window}, \param{int }{proportion = 0}, \param{int }{flag = 0}, \param{int }{border = 0}, \param{wxObject* }{userData = NULL}}
 | |
| 
 | |
| \func{wxSizerItem*}{Prepend}{\param{wxSizer* }{sizer}, \param{const wxSizerFlags\& }{flags}}
 | |
| 
 | |
| \func{wxSizerItem*}{Prepend}{\param{wxSizer* }{sizer}, \param{int }{proportion = 0}, \param{int }{flag = 0}, \param{int }{border = 0}, \param{wxObject* }{userData = NULL}}
 | |
| 
 | |
| \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}}
 | |
| 
 | |
| Same as \helpref{wxSizer::Add}{wxsizeradd}, but prepends the items to the beginning of the
 | |
| list of items (windows, subsizers or spaces) owned by this sizer.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::PrependSpacer}\label{wxsizerprependspacer}
 | |
| 
 | |
| \func{wxSizerItem*}{PrependSpacer}{\param{int }{size}}
 | |
| 
 | |
| Prepends non-stretchable space to the sizer. More readable way of calling
 | |
| \helpref{Prepend}{wxsizerprepend}(size, size, 0).
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::PrependStretchSpacer}\label{wxsizerprependstretchspacer}
 | |
| 
 | |
| \func{wxSizerItem*}{PrependStretchSpacer}{\param{int }{prop = 1}}
 | |
| 
 | |
| Prepends stretchable space to the sizer. More readable way of calling
 | |
| \helpref{Prepend}{wxsizerprepend}(0, 0, prop).
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::RecalcSizes}\label{wxsizerrecalcsizes}
 | |
| 
 | |
| \func{void}{RecalcSizes}{\void}
 | |
| 
 | |
| This method is abstract and has to be overwritten by any derived class.
 | |
| Here, the sizer will do the actual calculation of its children's positions
 | |
| and sizes.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::Remove}\label{wxsizerremove}
 | |
| 
 | |
| \func{bool}{Remove}{\param{wxWindow* }{window}}
 | |
| 
 | |
| \func{bool}{Remove}{\param{wxSizer* }{sizer}}
 | |
| 
 | |
| \func{bool}{Remove}{\param{size\_t }{index}}
 | |
| 
 | |
| Removes a child from the sizer and destroys it if it is a sizer or a spacer,
 | |
| but not if it is a window (because windows are owned by their parent window,
 | |
| not the sizer).  \arg{sizer} is the wxSizer to be removed,
 | |
| \arg{index} is the position of the child in the sizer, e.g. $0$ for the first item.
 | |
| This method does not cause any layout or resizing to take place, call
 | |
| \helpref{wxSizer::Layout}{wxsizerlayout} to update the layout "on screen" after removing a
 | |
| child from the sizer.
 | |
| 
 | |
| {\bf NB:} The method taking a wxWindow* parameter is deprecated as it does not
 | |
| destroy the window as would usually be expected from Remove.  You should use 
 | |
| \helpref{wxSizer::Detach}{wxsizerdetach} in new code instead.  There is
 | |
| currently no wxSizer method that will both detach and destroy a wxWindow item.
 | |
| 
 | |
| Returns true if the child item was found and removed, false otherwise.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::Replace}\label{wxsizerreplace}
 | |
| 
 | |
| \func{bool}{Replace}{\param{wxWindow* }{oldwin}, \param{wxWindow* }{newwin}, \param{bool }{recursive = false}}
 | |
| 
 | |
| \func{bool}{Replace}{\param{wxSizer* }{oldsz}, \param{wxSizer* }{newsz}, \param{bool }{recursive = false}}
 | |
| 
 | |
| \func{bool}{Remove}{\param{size\_t }{oldindex}, \param{wxSizerItem* }{newitem}}
 | |
| 
 | |
| Detaches the given \arg{oldwin}, \arg{oldsz} child from the sizer and 
 | |
| replaces it with the given window, sizer, or wxSizerItem.
 | |
| 
 | |
| The detached child is removed {\bf only} if it is a sizer or a spacer
 | |
| (because windows are owned by their parent window, not the sizer).
 | |
| 
 | |
| Use parameter \arg{recursive} to search the given element recursively in subsizers.
 | |
| 
 | |
| 
 | |
| This method does not cause any layout or resizing to take place, call
 | |
| \helpref{wxSizer::Layout}{wxsizerlayout} to update the layout "on screen" after replacing a
 | |
| child from the sizer.
 | |
| 
 | |
| Returns true if the child item was found and removed, false otherwise.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::SetDimension}\label{wxsizersetdimension}
 | |
| 
 | |
| \func{void}{SetDimension}{\param{int }{x}, \param{int }{y}, \param{int }{width}, \param{int }{height}}
 | |
| 
 | |
| Call this to force the sizer to take the given dimension and thus force the items owned
 | |
| by the sizer to resize themselves according to the rules defined by the parameter in the 
 | |
| \helpref{Add}{wxsizeradd} and \helpref{Prepend}{wxsizerprepend} methods.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::SetMinSize}\label{wxsizersetminsize}
 | |
| 
 | |
| \func{void}{SetMinSize}{\param{int }{width}, \param{int }{height}}
 | |
| 
 | |
| \func{void}{SetMinSize}{\param{const wxSize\& }{size}}
 | |
| 
 | |
| Call this to give the sizer a minimal size. Normally, the sizer will calculate its
 | |
| minimal size based purely on how much space its children need. After calling this
 | |
| method \helpref{GetMinSize}{wxsizergetminsize} will return either the minimal size
 | |
| as requested by its children or the minimal size set here, depending on which is
 | |
| bigger.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::SetItemMinSize}\label{wxsizersetitemminsize}
 | |
| 
 | |
| \func{void}{SetItemMinSize}{\param{wxWindow* }{window}, \param{int}{ width}, \param{int}{ height}}
 | |
| 
 | |
| \func{void}{SetItemMinSize}{\param{wxSizer* }{sizer}, \param{int}{ width}, \param{int}{ height}}
 | |
| 
 | |
| \func{void}{SetItemMinSize}{\param{size\_t }{index}, \param{int}{ width}, \param{int}{ height}}
 | |
| 
 | |
| Set an item's minimum size by window, sizer, or position. The item will be found recursively
 | |
| in the sizer's descendants. This function enables an application to set the size of an item
 | |
| after initial creation.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::SetSizeHints}\label{wxsizersetsizehints}
 | |
| 
 | |
| \func{void}{SetSizeHints}{\param{wxWindow* }{window}}
 | |
| 
 | |
| This method first calls \helpref{wxSizer::Fit}{wxsizerfit} and then 
 | |
| \helpref{SetSizeHints}{wxtoplevelwindowsetsizehints} on the {\it window}
 | |
| passed to it. This only makes sense when {\it window} is actually a
 | |
| \helpref{wxTopLevelWindow}{wxtoplevelwindow} such as a wxFrame or a
 | |
| wxDialog, since SetSizeHints only has any effect in these classes. 
 | |
| It does nothing in normal windows or controls.
 | |
| 
 | |
| This method is commonly invoked in the constructor of a toplevel window itself
 | |
| (see the sample in the description of \helpref{wxBoxSizer}{wxboxsizer}) if the
 | |
| toplevel window is resizable.
 | |
| 
 | |
| \membersection{wxSizer::SetVirtualSizeHints}\label{wxsizersetvirtualsizehints}
 | |
| 
 | |
| \func{void}{SetVirtualSizeHints}{\param{wxWindow* }{window}}
 | |
| 
 | |
| Tell the sizer to set the minimal size of the \arg{window} virtual area to match the sizer's
 | |
| minimal size. For windows with managed scrollbars this will set them appropriately.
 | |
| 
 | |
| \wxheading{See also}
 | |
| 
 | |
| \helpref{wxScrolledWindow::SetScrollbars}{wxscrolledwindowsetscrollbars}
 | |
| 
 | |
| 
 | |
| \membersection{wxSizer::Show}\label{wxsizershow}
 | |
| 
 | |
| \func{bool}{Show}{\param{wxWindow* }{window}, \param{bool }{show = true}, \param{bool }{recursive = false}}
 | |
| 
 | |
| \func{bool}{Show}{\param{wxSizer* }{sizer}, \param{bool }{show = true}, \param{bool }{recursive = false}}
 | |
| 
 | |
| \func{bool}{Show}{\param{size\_t }{index}, \param{bool }{show = true}}
 | |
| 
 | |
| Shows or hides the \arg{window}, \arg{sizer}, or item at \arg{index}.
 | |
| To make a sizer item disappear or reappear, use Show() followed by \helpref{Layout()}{wxsizerlayout}.
 | |
| Use parameter \arg{recursive} to show or hide elements found in subsizers.
 | |
| 
 | |
| Returns true if the child item was found, false otherwise.
 | |
| 
 | |
| \wxheading{See also}
 | |
| 
 | |
| \helpref{wxSizer::Hide}{wxsizerhide},\rtfsp
 | |
| \helpref{wxSizer::IsShown}{wxsizerisshown}
 | |
| 
 | |
| 
 | |
| 
 | |
| 
 | |
| \section{\class{wxSizerFlags}}\label{wxsizerflags}
 | |
| 
 | |
| Normally, when you add an item to a sizer via 
 | |
| \helpref{wxSizer::Add}{wxsizeradd}, you have to specify a lot of flags and
 | |
| parameters which can be unwieldy. This is where wxSizerFlags comes in: it
 | |
| allows you to specify all parameters using the named methods instead. For
 | |
| example, instead of
 | |
| 
 | |
| \begin{verbatim}
 | |
|     sizer->Add(ctrl, 0, wxEXPAND | wxBORDER, 10);
 | |
| \end{verbatim}
 | |
| 
 | |
| you can now write
 | |
| 
 | |
| \begin{verbatim}
 | |
|     sizer->Add(ctrl, wxSizerFlags().Expand().Border(10));
 | |
| \end{verbatim}
 | |
| 
 | |
| This is more readable and also allows you to create wxSizerFlags objects which
 | |
| can be reused for several sizer items.
 | |
| \begin{verbatim}
 | |
|     wxSizerFlags flagsExpand(1);
 | |
|     flagsExpand.Expand().Border(10);
 | |
| 
 | |
|     sizer->Add(ctrl1, flagsExpand);
 | |
|     sizer->Add(ctrl2, flagsExpand);
 | |
| \end{verbatim}
 | |
| 
 | |
| Note that by specification, all methods of wxSizerFlags return the wxSizerFlags
 | |
| object itself to allowing chaining multiple methods calls like in the examples
 | |
| above.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizerFlags::wxSizerFlags}\label{wxsizerflagsctor}
 | |
| 
 | |
| \func{}{wxSizerFlags}{\param{int }{proportion = 0}}
 | |
| 
 | |
| Creates the wxSizer with the proportion specified by \arg{proportion}.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizerFlags::Align}\label{wxsizerflagsalign}
 | |
| 
 | |
| \func{wxSizerFlags\& }{Align}{\param{int }{align = 0}}
 | |
| 
 | |
| Sets the alignment of this wxSizerFlags to \arg{align}.
 | |
| 
 | |
| Note that if this method is not called, the wxSizerFlags has no specified alignment.
 | |
| 
 | |
| \wxheading{See also}
 | |
| 
 | |
| \helpref{Left}{wxsizerflagsleft},\\
 | |
| \helpref{Right}{wxsizerflagsright},\\
 | |
| \helpref{Centre}{wxsizerflagscentre}
 | |
| 
 | |
| 
 | |
| \membersection{wxSizerFlags::Border}\label{wxsizerflagsborder}
 | |
| 
 | |
| \func{wxSizerFlags\& }{Border}{\param{int }{direction}, \param{int }{borderinpixels}}
 | |
| 
 | |
| \func{wxSizerFlags\& }{Border}{\param{int }{direction = wxALL}}
 | |
| 
 | |
| Sets the wxSizerFlags to have a border of a number of pixels specified by
 | |
| \arg{borderinpixels} with the directions specified by \arg{direction}.
 | |
| 
 | |
| In the overloaded version without \arg{borderinpixels} parameter, the border of
 | |
| default size, as returned by \helpref{GetDefaultBorder}{wxsizerflagsgetdefaultborder},
 | |
| is used.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizerFlags::Center}\label{wxsizerflagscenter}
 | |
| 
 | |
| \func{wxSizerFlags\& }{Center}{\void}
 | |
| 
 | |
| Sets the object of the wxSizerFlags to center itself in the area it is given.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizerFlags::Centre}\label{wxsizerflagscentre}
 | |
| 
 | |
| \func{wxSizerFlags\& }{Centre}{\void}
 | |
| 
 | |
| \helpref{wxSizerFlags::Center}{wxsizerflagscenter} for people with the other dialect of english.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizerFlags::DoubleBorder}\label{wxsizerflagsdoubleborder}
 | |
| 
 | |
| \func{wxSizerFlags\& }{DoubleBorder}{\param{int }{direction = wxALL}}
 | |
| 
 | |
| Sets the border in the given \arg{direction} having twice the default border
 | |
| size.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizerFlags::DoubleHorzBorder}\label{wxsizerflagsdoublehorzborder}
 | |
| 
 | |
| \func{wxSizerFlags\& }{DoubleHorzBorder}{\void}
 | |
| 
 | |
| Sets the border in left and right directions having twice the default border
 | |
| size.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizerFlags::Expand}\label{wxsizerflagsexpand}
 | |
| 
 | |
| \func{wxSizerFlags\& }{Expand}{\void}
 | |
| 
 | |
| Sets the object of the wxSizerFlags to expand to fill as much area as it can.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizerFlags::GetDefaultBorder}\label{wxsizerflagsgetdefaultborder}
 | |
| 
 | |
| \func{static int}{GetDefaultBorder}{\void}
 | |
| 
 | |
| Returns the border used by default in \helpref{Border}{wxsizerflagsborder} method.
 | |
| 
 | |
| 
 | |
| \membersection{wxSizerFlags::Left}\label{wxsizerflagsleft}
 | |
| 
 | |
| \func{wxSizerFlags\& }{Left}{\void}
 | |
| 
 | |
| Aligns the object to the left, shortcut for \texttt{Align(wxALIGN\_LEFT)}
 | |
| 
 | |
| \wxheading{See also}
 | |
| 
 | |
| \helpref{Align}{wxsizerflagsalign}
 | |
| 
 | |
| 
 | |
| \membersection{wxSizerFlags::Proportion}\label{wxsizerflagsproportion}
 | |
| 
 | |
| \func{wxSizerFlags\& }{Proportion}{\param{int }{proportion = 0}}
 | |
| 
 | |
| Sets the proportion of this wxSizerFlags to \arg{proportion}
 | |
| 
 | |
| 
 | |
| \membersection{wxSizerFlags::Right}\label{wxsizerflagsright}
 | |
| 
 | |
| \func{wxSizerFlags\& }{Right}{\void}
 | |
| 
 | |
| Aligns the object to the right, shortcut for \texttt{Align(wxALIGN\_RIGHT)}
 | |
| 
 | |
| \wxheading{See also}
 | |
| 
 | |
| \helpref{Align}{wxsizerflagsalign}
 | |
| 
 | |
| 
 | |
| \membersection{wxSizerFlags::TripleBorder}\label{wxsizerflagstriplebleborder}
 | |
| 
 | |
| \func{wxSizerFlags\& }{TripleBorder}{\param{int }{direction = wxALL}}
 | |
| 
 | |
| Sets the border in the given \arg{direction} having thrice the default border
 | |
| size.
 | |
| 
 | |
| 
 |