X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/36be32ecdc225893cbffb1b57cc4f014c463b383..2706e543a6923d8e743c6ec21fcfe898a52aec88:/docs/latex/wx/size.tex diff --git a/docs/latex/wx/size.tex b/docs/latex/wx/size.tex index 738f5b2edd..6034d1edbc 100644 --- a/docs/latex/wx/size.tex +++ b/docs/latex/wx/size.tex @@ -1,9 +1,19 @@ +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Name: size.tex +%% Purpose: wxSize documentation +%% Author: wxTeam +%% Created: +%% RCS-ID: $Id$ +%% Copyright: (c) wxTeam +%% License: wxWindows license +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + \section{\class{wxSize}}\label{wxsize} A {\bf wxSize} is a useful data structure for graphics operations. It simply contains integer {\it width} and {\it height} members. -wxSize is used throughout wxWindows as well as wxPoint which, although almost +wxSize is used throughout wxWidgets as well as wxPoint which, although almost equivalent to wxSize, has a different meaning: wxPoint represents a position while wxSize - the size. @@ -20,13 +30,18 @@ None +\wxheading{Library} + +\helpref{wxCore}{librarieslist} + \wxheading{See also} \helpref{wxPoint}{wxpoint}, \helpref{wxRealPoint}{wxrealpoint} \latexignore{\rtfignore{\wxheading{Members}}} -\membersection{wxSize::wxSize} + +\membersection{wxSize::wxSize}\label{wxsizector} \func{}{wxSize}{\void} @@ -35,9 +50,31 @@ None Creates a size object. + +\membersection{wxSize::DecBy}\label{wxsizedecby} + +\func{void}{DecBy}{\param{const wxSize\& }{size}} + +\func{void}{DecBy}{\param{int }{dx}, \param{int }{dy}} + +\func{void}{DecBy}{\param{int }{d}} + +Decreases the size in x- and y- directions + +\begin{enumerate} + \item By \arg{size.x} and \arg{size.y} for the first overload + \item By \arg{dx} and \arg{dy} for the second one + \item By \arg{d} and \arg{d} for the third one +\end{enumerate} + +\wxheading{See also} + +\helpref{IncBy}{wxsizeincby} + + \membersection{wxSize::DecTo}\label{wxsizedecto} -\func{wxSize\&}{DecTo}{\param{const wxSize\& }{size}} +\func{void}{DecTo}{\param{const wxSize\& }{size}} Decrements this object so that both of its dimensions are not greater than the corresponding dimensions of the \arg{size}. @@ -47,12 +84,25 @@ corresponding dimensions of the \arg{size}. \helpref{IncTo}{wxsizeincto} +\membersection{wxSize::IsFullySpecified}\label{wxsizeisfullyspecified} + +\constfunc{bool}{IsFullySpecified}{\void} + +Returns \true if neither of the size object components is equal to $-1$, which +is used as default for the size values in wxWidgets (hence the predefined +\texttt{wxDefaultSize} has both of its components equal to $-1$). + +This method is typically used before calling +\helpref{SetDefaults}{wxsizesetdefaults}. + + \membersection{wxSize::GetWidth}\label{wxsizegetwidth} \constfunc{int}{GetWidth}{\void} Gets the width member. + \membersection{wxSize::GetHeight}\label{wxsizegetheight} \constfunc{int}{GetHeight}{\void} @@ -60,9 +110,30 @@ Gets the width member. Gets the height member. +\membersection{wxSize::IncBy}\label{wxsizeincby} + +\func{void}{IncBy}{\param{const wxSize\& }{size}} + +\func{void}{IncBy}{\param{int }{dx}, \param{int }{dy}} + +\func{void}{IncBy}{\param{int }{d}} + +Increases the size in x- and y- directions + +\begin{enumerate} + \item By \arg{size.x} and \arg{size.y} for the first overload + \item By \arg{dx} and \arg{dy} for the second one + \item By \arg{d} and \arg{d} for the third one +\end{enumerate} + +\wxheading{See also} + +\helpref{DecBy}{wxsizedecby} + + \membersection{wxSize::IncTo}\label{wxsizeincto} -\func{wxSize\&}{IncTo}{\param{const wxSize\& }{size}} +\func{void}{IncTo}{\param{const wxSize\& }{size}} Increments this object so that both of its dimensions are not less than the corresponding dimensions of the \arg{size}. @@ -72,28 +143,89 @@ corresponding dimensions of the \arg{size}. \helpref{DecTo}{wxsizedecto} + +\membersection{wxSize::Scale}\label{wxsizescale} + +\func{wxSize\&}{Scale}{\param{float}{ xscale}, \param{float}{ yscale}} + +Scales the dimensions of this object by the given factors. +If you want to scale both dimensions by the same factor you can also use +the \helpref{operator *=}{wxsizeoperators} + +Returns a reference to this object (so that you can concatenate other operations in the same line). + + \membersection{wxSize::Set}\label{wxsizeset} \func{void}{Set}{\param{int}{ width}, \param{int}{ height}} Sets the width and height members. + +\membersection{wxSize::SetDefaults}\label{wxsizesetdefaults} + +\func{void}{SetDefaults}{\param{const wxSize\& }{sizeDefault}} + +Combine this size object with another one replacing the default (i.e. equal +to $-1$) components of this object with those of the other. It is typically +used like this: +\begin{verbatim} + if ( !size.IsFullySpecified() ) + { + size.SetDefaults(GetDefaultSize()); + } +\end{verbatim} + +\wxheading{See also} + +\helpref{IsFullySpecified}{wxsizeisfullyspecified} + + \membersection{wxSize::SetHeight}\label{wxsizesetheight} \func{void}{SetHeight}{\param{int}{ height}} Sets the height. + \membersection{wxSize::SetWidth}\label{wxsizesetwidth} \func{void}{SetWidth}{\param{int}{ width}} Sets the width. -\membersection{wxSize::operator $=$} + +\membersection{Operators}\label{wxsizeoperators} \func{void}{operator $=$}{\param{const wxSize\& }{sz}} Assignment operator. +\func{bool}{operator $==$}{\param{const wxSize\& }{s1}, \param{const wxSize\& }{s2}} + +\func{bool}{operator $!=$}{\param{const wxSize\& }{s1}, \param{const wxSize\& }{s2}} + +\func{wxSize}{operator $+$}{\param{const wxSize\& }{s1}, \param{const wxSize\& }{s2}} + +\func{wxSize}{operator $-$}{\param{const wxSize\& }{s1}, \param{const wxSize\& }{s2}} + +\func{wxSize\&}{operator $+=$}{\param{const wxSize\& }{sz}} + +\func{wxSize\&}{operator $-=$}{\param{const wxSize\& }{sz}} + +Operators for comparison, sum and subtraction between \helpref{wxSize}{wxsize} objects. + + +\func{wxSize}{operator $/$}{\param{const wxSize\& }{sz}, \param{int }{factor}} + +\func{wxSize}{operator $*$}{\param{const wxSize\& }{sz}, \param{int }{factor}} + +\func{wxSize}{operator $*$}{\param{int }{factor}, \param{const wxSize\& }{sz}} + +\func{wxSize\&}{operator $/=$}{\param{int }{factor}} + +\func{wxSize\&}{operator $*=$}{\param{int }{factor}} + +Operators for division and multiplication between a \helpref{wxSize}{wxsize} object and an integer. +