]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/latex/wx/size.tex
HitTest() seems to be implemented on most platforms now (replaces patch 1467212)
[wxWidgets.git] / docs / latex / wx / size.tex
index a29fc0648403e270d5ca0d3a21dae2be04d61189..b1376b4f21947ff3089f836057882ce1520b9532 100644 (file)
@@ -3,7 +3,7 @@
 A {\bf wxSize} is a useful data structure for graphics operations.
 It simply contains integer {\it width} and {\it height} members.
 
 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.
 
 equivalent to wxSize, has a different meaning: wxPoint represents a position
 while wxSize - the size.
 
@@ -26,7 +26,8 @@ None
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
-\membersection{wxSize::wxSize}
+
+\membersection{wxSize::wxSize}\label{wxsizector}
 
 \func{}{wxSize}{\void}
 
 
 \func{}{wxSize}{\void}
 
@@ -34,37 +35,101 @@ None
 
 Creates a size object.
 
 
 Creates a size object.
 
+
+
+\membersection{wxSize::DecTo}\label{wxsizedecto}
+
+\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}.
+
+\wxheading{See also}
+
+\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::GetWidth}\label{wxsizegetwidth}
 
 \constfunc{int}{GetWidth}{\void}
 
 Gets the width member.
 
+
 \membersection{wxSize::GetHeight}\label{wxsizegetheight}
 
 \constfunc{int}{GetHeight}{\void}
 
 Gets the height member.
 
 \membersection{wxSize::GetHeight}\label{wxsizegetheight}
 
 \constfunc{int}{GetHeight}{\void}
 
 Gets the height member.
 
+
+
+\membersection{wxSize::IncTo}\label{wxsizeincto}
+
+\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}.
+
+\wxheading{See also}
+
+\helpref{DecTo}{wxsizedecto}
+
+
+
 \membersection{wxSize::Set}\label{wxsizeset}
 
 \func{void}{Set}{\param{int}{ width}, \param{int}{ height}}
 
 Sets the width and height members.
 
 \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::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::SetWidth}\label{wxsizesetwidth}
 
 \func{void}{SetWidth}{\param{int}{ width}}
 
 Sets the width.
 
-\membersection{wxSize::operator $=$}
+
+\membersection{wxSize::operator $=$}\label{wxsizeassign}
 
 \func{void}{operator $=$}{\param{const wxSize\& }{sz}}
 
 
 \func{void}{operator $=$}{\param{const wxSize\& }{sz}}