Region Class

Represent the interior of a graphics shape composed of rectangles.

Inheritance

object

MarshalByRefObject

GdiObject

Region

Implements

IDisposable

ICloneable

Namespace: C1.Framework.Drawing.Gdi

Assembly: C1.Win.C1Input.4.8.dll

Syntax

public sealed class Region : GdiObject, IDisposable, ICloneable

Public NotInheritable Class Region
    Inherits GdiObject
    Implements IDisposable, ICloneable

Remarks

A region is scalable because its coordinates are specified in world coordinates. On a drawing surface, however, its interior is dependent on the size and shape of the pixels representing it. An application can use regions to clamp the output of drawing operations. The window manager uses regions to define the drawing area of these regions are called clipping regions. An application can also use regions in hit-testing operations, such as checking whether a point or a rectangle intersects a region. An application can fill a region by using a Brush object.

cnotes

This class uses the Win32 GDI API's for handling regions. The GDI+ version Region class just seems to be buggy and too slow.

Constructors

Name	Description
Region()	Initializes a new Region object.
Region(RegionData)	Initializes a new Region object from the RegionData object.
Region(Rectangle)	Initializes a new Region object from the specified Rectangle structure.

Properties

Name	Description
Handle	Get a handle which is being transformed to this Region object.

Methods

Name	Description
Clone()	Creates an exact copy if this Region object.
Complement(Region)	Updates this Region object to contain the portion of the specified Region object that does not intersect with this Region object.
Complement(Rectangle)	Updates this Region object to contain the portion of the specified Rectangle structure that does not intersect with this Region object.
CreateChordRegion(Rectangle, float, float)	Creates a chord region (a region bounded by the intersection of an ellipse and a line segment, called a secant).
CreateEllipseRegion(Rectangle)	Create a ellipse region.
CreatePieRegion(Rectangle, float, float)	Create a pie region.
CreatePolygonRegion(Point[])	Create a polygons region from the point array which defines the vertices of the polygon.
CreatePolygonRegion(Point[], PolyFillMode)	Create a polygons region from the point array which defines the vertices of the polygon.
CreateRoundedRectangleRegion(Rectangle, int, int)	Creates a rectangular Region with rounded corners.
Equals(Region)	Tests whether the specified Region object is identical to this Region object.
Exclude(Region)	Updates this Region object to the portion of its interior that does not intersect with the specified Region object.
Exclude(Rectangle)	Updates this Region object to the portion of its interior that does not intersect with the specified Rectangle structure.
FromGdiplusRegion(Region)	Create a new gdi region that is same as the gdi+ region.
GetBounds()	Gets a Rectangle structure that represents a rectangle that bounds this Region object.
GetData()	Retieves the rectangle information that makes up this instance of the Region object.
Intersect(Region)	Updates this Region object to the intersection of itself with the specified Region object.
Intersect(Rectangle)	Updates this Region object to the intersection of itself with the specified Rectangle structure.
IsEmpty()	Tests whether this Region object has an empty interior.
IsVisible(Point)	Tests whether the specified Point structure is contained within this Region object.
IsVisible(Rectangle)	Tests whether any portion of the specified Rectangle structure is contained within this Region object.
MakeEmpty()	Initializes this Region object to an empty interior.
Scan(Region)	Returns an array of Rectangle structures that approximate this Region object.
ToGdiplusRegion(Region)	Creates a new gdi+ Region object from the gdi Region object.
Translate(int, int)	Offsets the coordinates of this Region object by the specified amount.
Union(Region)	Updates this Region object to the union of itself and the specified Region object.
Union(Rectangle)	Updates this Region object to the union of itself and the specified Rectangle structure.
Xor(Region)	Updates this Region object to the union minus the intersection of itself with the specified Region object.
Xor(Rectangle)	Updates this Region object to the union minus the intersection of itself with the specified Rectangle strcuture.