X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/1c0c339c2d391168461dece5e97571f5f12a5026..3e60899273993070615df55ff895cc39346754b9:/docs/latex/wx/sizer.tex diff --git a/docs/latex/wx/sizer.tex b/docs/latex/wx/sizer.tex index f39b4aeabc..e052026c43 100644 --- a/docs/latex/wx/sizer.tex +++ b/docs/latex/wx/sizer.tex @@ -74,7 +74,7 @@ sizer and thus to create hierarchies of sizers (typically a vertical box as the 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 flexilibilty in the design of dialogs; imagine for example a horizontal box with two buttons at the +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 {\it option} 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 @@ -82,7 +82,7 @@ the dialog.} \docparam{option}{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 changable and a value of more than zero is interpreted relative to the value of other +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.} @@ -125,11 +125,25 @@ Here, the sizer will do the actual calculation of its children minimal sizes. \membersection{wxSizer::Fit}\label{wxsizerfit} -\func{void}{Fit}{\param{wxWindow* }{window}} +\func{wxSize}{Fit}{\param{wxWindow* }{window}} Tell the sizer to resize the {\it 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}. +of \helpref{wxBoxSizer}{wxboxsizer}. Returns the new size. + +\membersection{wxSizer::FitInside}\label{wxsizerfitinside} + +\func{void}{FitInside}{\param{wxWindow* }{window}} + +Tell the sizer to resize the virtual size of the {\it 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::GetSize}\label{wxsizergetsize} @@ -190,7 +204,7 @@ Removes a child from the sizer. {\it window} is the window to be removed, {\it s equivalent sizer and {\it nth} 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 and does not delete the window itself. Call \helpref{wxSizer::Layout}{wxsizerlayout} to update -the layout "on screen" after removing a child fom the sizer. +the layout "on screen" after removing a child from the sizer. Returns TRUE if the child item was found and removed, FALSE otherwise. @@ -199,7 +213,7 @@ Returns TRUE if the child item was found and removed, FALSE otherwise. \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 paramater in the +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} @@ -230,8 +244,19 @@ after initial creation. \func{void}{SetSizeHints}{\param{wxWindow* }{window}} -Tell the sizer to set the minimal size of the {\it 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} if the window is resizable (as are many dialogs under Unix and -frames on probably all platforms). +Tell the sizer to set (and \helpref{Fit}{wxsizerfit}) the minimal size of the {\it 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} if the window is resizable +(as are many dialogs under Unix and frames on probably all platforms). + +\membersection{wxSizer::SetVirtualSizeHints}\label{wxsizersetvirtualsizehints} + +\func{void}{SetVirtualSizeHints}{\param{wxWindow* }{window}} + +Tell the sizer to set the minimal size of the {\it 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}