added and documented SplitVolume() and GetPathTerminators(); corrected SetPath()...

[wxWidgets.git] / docs / latex / wx / size.tex

diff --git a/docs/latex/wx/size.tex b/docs/latex/wx/size.tex
index fa873320527ecdd7efaec9e0db8838fd347d7795..78648cfa8b9321b782fca95de66346015ab23a18 100644 (file)
--- a/docs/latex/wx/size.tex
+++ b/docs/latex/wx/size.tex
@@ -1,12 +1,15 @@
 \section{\class{wxSize}}\label{wxsize}
 
 A {\bf wxSize} is a useful data structure for graphics operations.
 \section{\class{wxSize}}\label{wxsize}
 
 A {\bf wxSize} is a useful data structure for graphics operations.

-It simply contains integer {\it x} and {\it y} members.
+It simply contains integer {\it width} and {\it height} members.

 
 

-\pythonnote{wxPython defines aliases for the \tt{x} and \tt{y} members
-named \tt{width} and \tt{height} since it makes much more sense for
-sizes.  There is also coresponding aliases for the  \tt{GetWidth} and
-\tt{GetHeight} methods.
+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.
+
+\pythonnote{wxPython defines aliases for the {\tt x} and {\tt y} members
+named {\tt width} and {\tt height} since it makes much more sense for
+sizes.

 }
 
 \wxheading{Derived from}
 }
 
 \wxheading{Derived from}


@@ -23,43 +26,108 @@ None
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 

+

 \membersection{wxSize::wxSize}
 
 \func{}{wxSize}{\void}
 
 \membersection{wxSize::wxSize}
 
 \func{}{wxSize}{\void}
 

-\func{}{wxSize}{\param{int}{ x}, \param{int}{ y}}
+\func{}{wxSize}{\param{int}{ width}, \param{int}{ height}}

 
 Creates a size object.
 
 
 Creates a size object.
 

-\membersection{wxSize::x}

 
 

-\member{int}{x}

 
 

-x member.
+\membersection{wxSize::DecTo}\label{wxsizedecto}
+
+\func{wxSize\&}{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}

 
 

-\membersection{wxSize::y}
+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$).

 
 

-\member{int}{ y}
+This method is typically used before calling 
+\helpref{SetDefaults}{wxsizesetdefaults}.

 
 

-y member.

 
 

-\membersection{wxSize::GetX}\label{wxsizegetx}
+\membersection{wxSize::GetWidth}\label{wxsizegetwidth}

 
 

-\constfunc{int}{GetX}{\void}
+\constfunc{int}{GetWidth}{\void}

 
 

-Gets the x member.
+Gets the width member.

 
 

-\membersection{wxSize::GetY}\label{wxsizegety}

 
 

-\constfunc{int}{GetY}{\void}
+\membersection{wxSize::GetHeight}\label{wxsizegetheight}
+
+\constfunc{int}{GetHeight}{\void}
+
+Gets the height member.
+
+
+
+\membersection{wxSize::IncTo}\label{wxsizeincto}
+
+\func{wxSize\&}{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}
+

 
 

-Gets the y member.

 
 \membersection{wxSize::Set}\label{wxsizeset}
 
 
 \membersection{wxSize::Set}\label{wxsizeset}
 

-\func{void}{Set}{\param{int}{ x}, \param{int}{ y}}
+\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.

 
 

-Sets the x and y members.

 
 \membersection{wxSize::operator $=$}
 
 
 \membersection{wxSize::operator $=$}