a660d684ed
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@11 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
183 lines
5.3 KiB
TeX
183 lines
5.3 KiB
TeX
\section{\class{wxRegion}}\label{wxregion}
|
|
|
|
A wxRegion represents a simple or complex region on a device context or window. It uses
|
|
reference counting, so copying and assignment operations are fast.
|
|
|
|
\wxheading{Derived from}
|
|
|
|
\helpref{wxGDIObject}{wxgdiobject}\\
|
|
\helpref{wxObject}{wxobject}
|
|
|
|
\latexignore{\rtfignore{\wxheading{Members}}}
|
|
|
|
\membersection{wxRegion::wxRegion}\label{wxregionconstr}
|
|
|
|
\func{}{wxRegion}{\void}
|
|
|
|
Default constructor.
|
|
|
|
\func{}{wxRegion}{\param{long}{ x}, \param{long}{ y}, \param{long}{ width}, \param{long}{ height}}
|
|
|
|
Constructs a rectangular region with the given position and size.
|
|
|
|
\func{}{wxRegion}{\param{const wxPoint\&}{ topLeft}, \param{const wxPoint\&}{ bottomRight}}
|
|
|
|
Constructs a rectangular region from the top left point and the bottom right point.
|
|
|
|
\func{}{wxRegion}{\param{const wxRect\&}{ rect}}
|
|
|
|
Constructs a rectangular region a wxRect object.
|
|
|
|
\func{}{wxRegion}{\param{const wxRegion\&}{ region}}
|
|
|
|
Constructs a region by copying another region.
|
|
|
|
\membersection{wxRegion::\destruct{wxRegion}}
|
|
|
|
\func{}{\destruct{wxRegion}}{\void}
|
|
|
|
Destructor.
|
|
|
|
\membersection{wxRegion::Clear}\label{wxregionclear}
|
|
|
|
\func{void}{Clear}{\void}
|
|
|
|
Clears the current region.
|
|
|
|
\membersection{wxRegion::Contains}\label{wxregioncontains}
|
|
|
|
\constfunc{wxRegionContain}{Contains}{\param{long\& }{x}, \param{long\& }{y}}
|
|
|
|
Returns a value indicating whether the given point is contained within the region.
|
|
|
|
\constfunc{wxRegionContain}{Contains}{\param{const wxPoint\&}{ pt}}
|
|
|
|
Returns a value indicating whether the given point is contained within the region.
|
|
|
|
\constfunc{wxRegionContain}{Contains}{\param{long\& }{x}, \param{long\& }{y}, \param{long\& }{width}, \param{long\& }{height}}
|
|
|
|
Returns a value indicating whether the given rectangle is contained within the region.
|
|
|
|
\constfunc{wxRegionContain}{Contains}{\param{const wxRect\& }{rect}}
|
|
|
|
Returns a value indicating whether the given rectangle is contained within the region.
|
|
|
|
\wxheading{Return value}
|
|
|
|
The return value is one of wxOutRegion, wxPartRegion and wxInRegion.
|
|
|
|
On Windows, only wxOutRegion and wxInRegion are returned; a value wxInRegion then indicates that
|
|
all or some part of the region is contained in this region.
|
|
|
|
\membersection{wxRegion::GetBox}\label{wxregiongetbox}
|
|
|
|
\constfunc{void}{GetBox}{\param{long\& }{x}, \param{long\& }{y}, \param{long\& }{width}, \param{long\& }{height}}
|
|
|
|
Returns the outer bounds of the region.
|
|
|
|
\constfunc{wxRect}{GetBox}{\void}
|
|
|
|
Returns the outer bounds of the region.
|
|
|
|
\membersection{wxRegion::Intersect}\label{wxregionintersect}
|
|
|
|
\func{bool}{Intersect}{\param{long}{ x}, \param{long}{ y}, \param{long}{ width}, \param{long}{ height}}
|
|
|
|
Finds the intersection of this region and another, rectangular region, specified using position and size.
|
|
|
|
\func{bool}{Intersect}{\param{const wxRect\&}{ rect}}
|
|
|
|
Finds the intersection of this region and another, rectangular region.
|
|
|
|
\func{bool}{Intersect}{\param{const wxRegion\&}{ region}}
|
|
|
|
Finds the intersection of this region and another region.
|
|
|
|
\wxheading{Return value}
|
|
|
|
TRUE if successful, FALSE otherwise.
|
|
|
|
\wxheading{Remarks}
|
|
|
|
Creates the intersection of the two regions, that is, the parts which are in both regions. The result
|
|
is stored in this region.
|
|
|
|
\membersection{wxRegion::IsEmpty}\label{wxregionisempty}
|
|
|
|
\constfunc{bool}{IsEmpty}{\void}
|
|
|
|
\func{bool}{IsEmpty}{\void}
|
|
|
|
Returns TRUE if the region is empty, FALSE otherwise.
|
|
|
|
\func{bool}{Subtract}{\param{const wxRect\&}{ rect}}
|
|
|
|
Subtracts a rectangular region from this region.
|
|
|
|
\func{bool}{Subtract}{\param{const wxRegion\&}{ region}}
|
|
|
|
Subtracts a region from this region.
|
|
|
|
\wxheading{Return value}
|
|
|
|
TRUE if successful, FALSE otherwise.
|
|
|
|
\wxheading{Remarks}
|
|
|
|
This operation combines the parts of 'this' region that are not part of the second region.
|
|
The result is stored in this region.
|
|
|
|
\membersection{wxRegion::Union}\label{wxregionunion}
|
|
|
|
\func{bool}{Union}{\param{long}{ x}, \param{long}{ y}, \param{long}{ width}, \param{long}{ height}}
|
|
|
|
Finds the union of this region and another, rectangular region, specified using position and size.
|
|
|
|
\func{bool}{Union}{\param{const wxRect\&}{ rect}}
|
|
|
|
Finds the union of this region and another, rectangular region.
|
|
|
|
\func{bool}{Union}{\param{const wxRegion\&}{ region}}
|
|
|
|
Finds the union of this region and another region.
|
|
|
|
\wxheading{Return value}
|
|
|
|
TRUE if successful, FALSE otherwise.
|
|
|
|
\wxheading{Remarks}
|
|
|
|
This operation creates a region that combines all of this region and the second region.
|
|
The result is stored in this region.
|
|
|
|
\membersection{wxRegion::Xor}\label{wxregionxor}
|
|
|
|
\func{bool}{Xor}{\param{long}{ x}, \param{long}{ y}, \param{long}{ width}, \param{long}{ height}}
|
|
|
|
Finds the Xor of this region and another, rectangular region, specified using position and size.
|
|
|
|
\func{bool}{Xor}{\param{const wxRect\&}{ rect}}
|
|
|
|
Finds the Xor of this region and another, rectangular region.
|
|
|
|
\func{bool}{Xor}{\param{const wxRegion\&}{ region}}
|
|
|
|
Finds the Xor of this region and another region.
|
|
|
|
\wxheading{Return value}
|
|
|
|
TRUE if successful, FALSE otherwise.
|
|
|
|
\wxheading{Remarks}
|
|
|
|
This operation creates a region that combines all of this region and the second region, except
|
|
for any overlapping areas. The result is stored in this region.
|
|
|
|
\membersection{wxRegion::operator $=$}\label{wxregionassign}
|
|
|
|
\func{void}{operator $=$}{\param{const wxRegion\&}{ region}}
|
|
|
|
Copies {\it region} by reference counting.
|
|
|
|
|