Interface IGDIPlus.IGPRegion

This is a Beta Read Only version of this page. Please review and send recommendations to mitov@mitov.com. We will enable the editing as soon as we are happy with the overall Wiki site.

Package: SignalLabBasicPkg

Unit: IGDIPlus

Contents 1 Syntax 1.1 Delphi: 2 Summary 3 Description 4 Methods

Syntax

Delphi:

type IGPRegion = interface

Summary

Interface to a TGPRegion object.

Description

Defines interface to a TGPRegion object.

The TGPRegion class describes an area of the display surface. The area can be any shape. In other words, the boundary of the area can be a combination of curved and straight lines. Regions can also be created from the interiors of rectangles, paths, or a combination of these. Regions are used in clipping and hit-testing operations. Remarks A GDI+ region is stored in world coordinates whereas a GDI region is stored in device coordinates. Therefore, a GDI+ region is scalable and a GDI region is not. For more information, see Scalable Regions

An application can use regions to clip the output of drawing operations. The Window Manager uses regions to define the drawing area of windows. These regions are called clipping regions. An application can also use regions in hit-testing operations, such as checking whether a point is in a region or whether a rectangle intersects a region. For more information, see "Regions", "Clipping", and "Using Regions" on MSDN.

Methods

• function GetNativeRegion() : GpRegion
• function Clone() : TGPRegion - Makes a copy of this TGPRegion object and returns the address of the new TGPRegion object.
• function MakeInfinite() : TGPRegion - updates the region to an infinite region.
• function MakeEmpty() : TGPRegion - Updates the region to an empty region.
• function GetDataSize() : Cardinal - Gets the number of bytes of data that describes the region.
• function GetData() : TGPByteArray - Gets data that describes the region.
• function Intersect(rect : TGPRect) : TGPRegion - Updates the region to the portion of itself that intersects the specified rectangle's interior.
• function IntersectF(rect : TGPRectF) : TGPRegion - Updates the region to the portion of itself that intersects the specified rectangle's interior.
• function Intersect(path : IGPGraphicsPath) : TGPRegion - Updates the region to the portion of itself that intersects the specified path's interior.
• function Intersect(region : IGPRegion) : TGPRegion - Updates the region to the portion of itself that intersects another region.
• function Union(rect : TGPRect) : TGPRegion - Updates the region to all portions (intersecting and nonintersecting) of itself and all portions of the specified rectangle's interior.
• function UnionF(rect : TGPRectF) : TGPRegion - Updates the region to all portions (intersecting and nonintersecting) of itself and all portions of the specified rectangle's interior.
• function Union(path : IGPGraphicsPath) : TGPRegion - Updates the region to all portions (intersecting and nonintersecting) of itself and all portions of the specified path's interior.
• function Union(region : IGPRegion) : TGPRegion - Updates the region to all portions (intersecting and nonintersecting) of itself and all portions of another region.
• function XorRegion(rect : TGPRect) : TGPRegion - Updates the region to the nonintersecting portions of itself and the specified rectangle's interior.
• function XorRegionF(rect : TGPRectF) : TGPRegion - Updates the region to the nonintersecting portions of itself and the specified rectangle's interior.
• function XorRegion(path : IGPGraphicsPath) : TGPRegion - Updates the region to the nonintersecting portions of itself and the specified path's interior.
• function XorRegion(region : IGPRegion) : TGPRegion - Updates the region to the nonintersecting portions of itself and another region.
• function Exclude(rect : TGPRect) : TGPRegion - Updates the region to the portion of itself that does not intersect the specified rectangle's interior.
• function ExcludeF(rect : TGPRectF) : TGPRegion - Updates the region to the portion of itself that does not intersect the specified rectangle's interior.
• function Exclude(path : IGPGraphicsPath) : TGPRegion - Updates the region to the portion of itself that does not intersect the specified path's interior.
• function Exclude(region : IGPRegion) : TGPRegion - Updates the region to the portion of itself that does not intersect another region.
• function Complement(rect : TGPRect) : TGPRegion - Updates the region to the portion of the specified rectangle's interior that does not intersect the region.
• function ComplementF(rect : TGPRectF) : TGPRegion - Updates the region to the portion of the specified rectangle's interior that does not intersect the region.
• function Complement(path : IGPGraphicsPath) : TGPRegion - Updates the region to the portion of the specified path's interior that does not intersect the region.
• function Complement(region : IGPRegion) : TGPRegion - Updates the region to the portion of another region that does not intersect this region.
• function TranslateF(dx : Single; dy : Single) : TGPRegion - Offsets the region by specified amounts in the horizontal and vertical directions.
• function Translate(dx : Integer; dy : Integer) : TGPRegion - Offsets the region by specified amounts in the horizontal and vertical directions.
• function Transform(matrix : IGPMatrix) : TGPRegion - Transforms the region by multiplying each of its data points by a specified matrix.
• function GetBounds(g : IGPGraphics) : TGPRect - Gets a rectangle that encloses the region.
• function GetBoundsF(g : IGPGraphics) : TGPRectF - Gets a rectangle that encloses the region.
• function GetHRGN(g : IGPGraphics) : HRGN - Creates a Microsoft Windows Graphics Device Interface (GDI) region from the region.
• function IsEmpty(g : IGPGraphics) : Boolean - Determines whether the region is empty.
• function IsInfinite(g : IGPGraphics) : Boolean - Determines whether the region is infinite.
• function IsVisible(x : Integer; y : Integer; g : IGPGraphics) : Boolean - Determines whether a point is inside the region.
• function IsVisible(point : TGPPoint; g : IGPGraphics) : Boolean - Determines whether a point is inside the region.
• function IsVisibleF(x : Single; y : Single; g : IGPGraphics) : Boolean - Determines whether a point is inside the region.
• function IsVisibleF(point : TGPPointF; g : IGPGraphics) : Boolean - Determines whether a point is inside the region.
• function IsVisible(x : Integer; y : Integer; width : Integer; height : Integer; g : IGPGraphics) : Boolean - Determines whether a rectangle intersects the region.
• function IsVisible(rect : TGPRect; g : IGPGraphics) : Boolean - Determines whether a rectangle intersects the region.
• function IsVisibleF(x : Single; y : Single; width : Single; height : Single; g : IGPGraphics) : Boolean - Determines whether a rectangle intersects the region.
• function IsVisibleF(rect : TGPRectF; g : IGPGraphics) : Boolean - Determines whether a rectangle intersects the region.
• function Equals(region : IGPRegion; g : IGPGraphics) : Boolean - Determines whether the region is equal to another region.
• function GetRegionScansCount(matrix : IGPMatrix) : Cardinal - Returns the number of rectangles that approximate this region.
• function GetRegionScansF(matrix : IGPMatrix) : TGPRectFArray - Returns an array of rectangles that approximate the region.
• function GetRegionScans(matrix : IGPMatrix) : TGPRectArray - Returns an array of rectangles that approximate the region.