Region Functions (GDI+)

A Region 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.

Return Values

If the function succeeds, it returns Ok, which is an element of the Status enumeration.

 

If the function fails, it returns one of the other elements of the Status enumeration.

GdipCloneRegion

Description

Makes a copy of this Region  object and returns the address of the new Region  object.

Syntax

GpStatus WINGDIPAPI GdipCloneRegion(

    GpRegion *region,

    GpRegion **cloneRegion

);

PowerBASIC Syntax

DECLARE FUNCTION GdipCloneRegion ( _

    BYVAL region AS DWORD, _

    BYREF cloneRegion AS DWORD _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

cloneRegion

[in] Pointer to a variable that receives a pointer to the new Region object.

GdipCombineRegionPath

Description

Updates this region to the portion of itself that intersects the specified path's interior.

Syntax

GpStatus WINGDIPAPI GdipCombineRegionPath(

    GpRegion *region,

    GpPath *path,

    CombineMode combineMode

);

PowerBASIC Syntax

DECLARE FUNCTION GdipCombineRegionPath ( _

    BYVAL region AS DWORD, _

    BYVAL path AS DWORD, _

    BYVAL combineMode AS LONG _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

path

[in] Pointer to a GraphicsPath object that specifies the path to use to update this region.

combineMode

[in] Member of the CombineMode enumeration that specifies how the region and path are combined.

GdipCombineRegionRect

Description

Updates this region to the portion of itself that intersects the specified rectangle's interior.

Syntax

GpStatus WINGDIPAPI GdipCombineRegionRect(

    GpRegion *region,

    GDIPCONST GpRectF *rect,

    CombineMode combineMode

);

PowerBASIC Syntax

DECLARE FUNCTION GdipCombineRegionRect ( _

    BYVAL region AS DWORD, _

    BYREF pRect AS RectF, _

    BYVAL combineMode AS LONG _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

rect

[in] Reference to a rectangle to use to update this Region object.

combineMode

[in] Member of the CombineMode enumeration that specifies how the region and path are combined.

GdipCombineRegionRectI

Description

Updates this region to the portion of itself that intersects the specified rectangle's interior.

Syntax

GpStatus WINGDIPAPI GdipCombineRegionRectI(

    GpRegion *region,

    GDIPCONST GpRect *rect,

    CombineMode combineMode

);

PowerBASIC Syntax

DECLARE FUNCTION GdipCombineRegionRectI ( _

    BYVAL region AS DWORD, _

    BYREF pRect AS RectL, _

    BYVAL combineMode AS LONG _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

rect

[in] Reference to a rectangle to use to update this Region object.

combineMode

[in] Member of the CombineMode enumeration that specifies how the region and path are combined.

GdipCombineRegionRegion

Description

Updates this region to the portion of itself that intersects another region.

Syntax

GpStatus WINGDIPAPI GdipCombineRegionRegion(

    GpRegion *region,

    GpRegion *region2,

    CombineMode combineMode

);

PowerBASIC Syntax

DECLARE FUNCTION GdipCombineRegionRegion ( _

    BYVAL region AS DWORD, _

    BYVAL region2 AS DWORD, _

    BYVAL combineMode AS LONG _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

region2

[in] Pointer to a Region object to use to update this Region object.

combineMode

[in] Member of the CombineMode enumeration that specifies how the region and path are combined.

GdipCreateRegion

Description

Creates a region that is infinite. This is the default constructor.

Syntax

GpStatus WINGDIPAPI GdipCreateRegion(

    GpRegion **region

);

PowerBASIC Syntax

DECLARE FUNCTION GdipCreateRegion ( _

    BYREF region AS DWORD _

) AS LONG

Parameters

region

[out] Pointer to a variable that receives a pointer to the new created Region object.

GdipCreateRegionHrgn

Description

Creates a region that is identical to the region that is specified by a handle to a Microsoft Windows Graphics Device Interface (GDI) region.

Syntax

GpStatus WINGDIPAPI GdipCreateRegionHrgn(

    HRGN hRgn,

    GpRegion **region

);

PowerBASIC Syntax

DECLARE FUNCTION GdipCreateRegionHrgn ( _

    BYVAL hRgn AS DWORD, _

    BYREF region AS DWORD _

) AS LONG

Parameters

hRgn

[in] Handle to an existing GDI region.

region

[out] Pointer to a variable that receives a pointer to the new created Region object.

GdipCreateRegionPath

Description

Creates a region that is defined by a path (a GraphicsPath object) and has a fill mode that is contained in the GraphicsPath object.

Syntax

GpStatus WINGDIPAPI GdipCreateRegionPath(

    GpPath *path,

    GpRegion **region

);

PowerBASIC Syntax

DECLARE FUNCTION GdipCreateRegionPath ( _

    BYVAL path AS DWORD, _

    BYREF region AS DWORD _

) AS LONG

Parameters

path

[in] Pointer to a GraphicsPath object that specifies the path.

region

[out] Pointer to a variable that receives a pointer to the new created Region object.

GdipCreateRegionRect

Description

Creates a region that is defined by a rectangle.

Syntax

GpStatus WINGDIPAPI GdipCreateRegionRect(

    GDIPCONST GpRectF *rect,

    GpRegion **region

);

PowerBASIC Syntax

DECLARE FUNCTION GdipCreateRegionRect ( _

    BYREF pRect AS RectF, _

    BYREF region AS DWORD _

) AS LONG

Parameters

rect

[in] Reference to a rectangle.

region

[out] Pointer to the new created Region object.

GdipCreateRegionRectI

Description

Creates a region that is defined by a rectangle.

Syntax

GpStatus WINGDIPAPI GdipCreateRegionRectI(

    GDIPCONST GpRect *rect,

    GpRegion **region

);

PowerBASIC Syntax

DECLARE FUNCTION GdipCreateRegionRectI ( _

    BYREF pRect AS RectL, _

    BYREF region AS DWORD _

) AS LONG

Parameters

rect

[in] Reference to a rectangle.

region

[out] Pointer to a variable that receives a pointer to the new created Region object.

GdipCreateRegionRgnData

Description

Creates a region that is defined by data obtained from another region.

Syntax

GpStatus WINGDIPAPI GdipCreateRegionRgnData(

    GDIPCONST BYTE *regionData,

    INT size,

    GpRegion **region

);

PowerBASIC Syntax

DECLARE FUNCTION GdipCreateRegionRgnData ( _

    BYREF regionData AS ANY, _

    BYVAL psize AS LONG, _

    BYREF region AS DWORD _

) AS LONG

Parameters

regionData

[in] Pointer to an array of bytes that specifies a region. The data contained in the bytes is obtained from another region by using the GdipGetRegionData method.

size

[in] Long integer value that specifies the number of bytes in the regionData array.

region

[out] Pointer to a variable tghat receives a pointer to the new created Region object.

GdipDeleteRegion

Description

Deletes a Region object.

Syntax

GpStatus WINGDIPAPI GdipDeleteRegion(

    GpRegion *region

);

PowerBASIC Syntax

DECLARE FUNCTION GdipDeleteRegion ( _

    BYVAL region AS DWORD _

) AS LONG

Parameters

region

[in] Pointer to a variable that receives a pointer to the Region object.

GdipGetRegionBounds

Description

Gets a rectangle that encloses this region.

Syntax

GpStatus WINGDIPAPI GdipGetRegionBounds(

    GpRegion *region,

    GpGraphics *graphics,

    GpRectF *rect

);

PowerBASIC Syntax

DECLARE FUNCTION GdipGetRegionBounds ( _

    BYVAL region AS DWORD, _

    BYVAL graphics AS DWORD, _

    BYREF pRect AS RectF _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

graphics

[in] Pointer to a Graphics object that contains the world and page transformations required to calculate the device coordinates of this region and the rectangle.

rect

[out] Pointer to a RectF structure that receives the enclosing rectangle.

Remarks

The current world and page transformations of the graphics object are used to calculate the region and the rectangle as they are drawn on the display device. The rectangle returned by GdipGetRegionBounds is not always the smallest possible rectangle.

GdipGetRegionBoundsI

Description

Gets a rectangle that encloses this region.

Syntax

GpStatus WINGDIPAPI GdipGetRegionBoundsI(

    GpRegion *region,

    GpGraphics *graphics,

    GpRect *rect

);

PowerBASIC Syntax

DECLARE FUNCTION GdipGetRegionBoundsI ( _

    BYVAL region AS DWORD, _

    BYVAL graphics AS DWORD, _

    BYREF pRect AS RectL _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

graphics

[in] Pointer to a Graphics object that contains the world and page transformations required to calculate the device coordinates of this region and the rectangle.

rect

[out] Pointer to a RectL structure that receives the enclosing rectangle.

Remarks

The current world and page transformations of the graphics object are used to calculate the region and the rectangle as they are drawn on the display device. The rectangle returned by GdipGetRegionBounds is not always the smallest possible rectangle.

GdipGetRegionData

Description

Gets data that describes this region.

Syntax

GpStatus WINGDIPAPI GdipGetRegionData(

    GpRegion *region,

    BYTE * buffer,

    UINT bufferSize,

    UINT * sizeFilled

);

PowerBASIC Syntax

DECLARE FUNCTION GdipGetRegionData ( _

    BYVAL region AS DWORD, _

    BYREF buffer AS ANY, _

    BYVAL bufferSize AS DWORD, _

    BYREF sizeFilled AS DWORD _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

buffer

[out] Pointer to an array of BYTE values that receives the region data.

bufferSize

[in] Integer that specifies the size, in bytes, of the buffer array. The size of the buffer array can be greater than or equal to the number of bytes required to store the region data. The exact number of bytes required can be determined by calling the GdipGetRegionDataSize method.

sizeFilled

[out] Pointer to an LONG that receives the number of bytes of data actually received by the buffer array. The default value is NULL.

Remarks

The GdipGetRegionDataSize method can be used before the GdipGetRegionData method to determine the number of bytes needed to store the region data. Then, you can allocate a buffer that is the correct size to store the region data and set the buffer parameter to point to the buffer.

GdipGetRegionDataSize

Description

Gets the number of bytes of data that describes this region.

Syntax

GpStatus WINGDIPAPI GdipGetRegionDataSize(

    GpRegion *region,

    UINT * bufferSize

);

PowerBASIC Syntax

DECLARE FUNCTION GdipGetRegionDataSize ( _

    BYVAL region AS DWORD, _

    BYREF bufferSize AS DWORD _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

bufferSize

[out] Pointer to a variable that receives the number of bytes of region data.

Remarks

The GdipGetRegionDataSize method can be used before the GdipGetRegionData method to determine the number of bytes needed to store the region data. Then, you can allocate a buffer that is the correct size to store the region data that is obtained by the GdipGetRegionData.

GdipGetRegionHRgn

Description

Creates a Microsoft Windows Graphics Device Interface (GDI) region from this region.

Syntax

GpStatus WINGDIPAPI GdipGetRegionHRgn(

    GpRegion *region,

    GpGraphics *graphics,

    HRGN *hRgn

);

PowerBASIC Syntax

DECLARE FUNCTION GdipGetRegionHRgn ( _

    BYVAL region AS DWORD, _

    BYVAL graphics AS DWORD, _

    BYREF hRgn AS DWORD _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

graphics

[in] Pointer to a Graphics object that contains the world and page transformations required to calculate the device coordinates of this region.

hRgn

[out] Pointer to a variable that receives a Windows handle to a GDI region that is created from this region.

Remarks

It is the caller's responsibility to call the GDI function DeleteObject to free the GDI region when it is no longer needed.

GdipGetRegionScans

Description

Gets an array of rectangles that approximate this region. The region is transformed by a specified matrix before the rectangles are calculated.

Syntax

GpStatus WINGDIPAPI GdipGetRegionScans(

    GpRegion *region,

    GpRectF* rects,

    INT* count,

    GpMatrix* matrix

);

PowerBASIC Syntax

DECLARE FUNCTION GdipGetRegionScans ( _

    BYVAL region AS DWORD, _

    BYREF rects AS RectF, _

    BYREF count AS LONG, _

    BYVAL matrix AS DWORD _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

rects

[out] Pointer to an array of RectF structures that receives the rectangles.

count

[out] Pointer to a LONG that receives a value that indicates the number of rectangles that approximate this region. The value is valid even if rects is a NULL pointer.

matrix

[in] Pointer to a Matrix object that is used to transform the region.

Remarks

The GdipGetRegionScansCount method can be used first to determine the number of rectangles. Then, you can allocate a buffer that is the correct size and set the rects parameter to point to the buffer.

GdipGetRegionScansCount

Description

Gets the number of rectangles that approximate this region. The region is transformed by a specified matrix before the rectangles are calculated.

Syntax

GpStatus WINGDIPAPI GdipGetRegionScansCount(

    GpRegion *region,

    UINT* count,

    GpMatrix* matrix

);

PowerBASIC Syntax

DECLARE FUNCTION GdipGetRegionScansCount ( _

    BYVAL region AS DWORD, _

    BYREF count AS DWORD, _

    BYVAL matrix AS DWORD _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

count

[out] Pointer to an LONG that receives a value that indicates the number of rectangles that approximate this region.

matrix

[in] Pointer to a Matrix object that is used to transform the region.

Remarks

The GdipGetRegionScansCount method can be used before the GdipGetRegionScans method to determine the number of rectangles. Then, you can allocate a buffer that is the correct size to store the rectangles that are obtained with the GdipGetRegionScans method.

GdipGetRegionScansI

Description

Gets an array of rectangles that approximate this region. The region is transformed by a specified matrix before the rectangles are calculated.

Syntax

GpStatus WINGDIPAPI GdipGetRegionScansI(

    GpRegion *region,

    GpRect* rects,

    INT* count,

    GpMatrix* matrix

);

PowerBASIC Syntax

DECLARE FUNCTION GdipGetRegionScansI ( _

    BYVAL region AS DWORD, _

    BYREF rects AS RectL, _

    BYREF count AS LONG, _

    BYVAL matrix AS DWORD _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

rects

[out] Pointer to an array of RectL structures that receives the rectangles.

count

[out] Pointer to an LONG that receives a value that indicates the number of rectangles that approximate this region. The value is valid even if rects is a NULL pointer.

matrix

[in] Pointer to a Matrix object that is used to transform the region.

Remarks

The GdipGetRegionScansCount method can be used first to determine the number of rectangles. Then, you can allocate a buffer that is the correct size and set the rects parameter to point to the buffer.

GdipIsEmptyRegion

Description

Determines whether this region is empty.

Syntax

GpStatus WINGDIPAPI GdipIsEmptyRegion(

    GpRegion *region,

    GpGraphics *graphics,

    BOOL *result

);

PowerBASIC Syntax

DECLARE FUNCTION GdipIsEmptyRegion ( _

    BYVAL region AS DWORD, _

    BYVAL graphics AS DWORD, _

    BYREF result AS LONG _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

graphics

[in] Pointer to a Graphics object that contains the world and page transformations required to calculate the device coordinates of this region.

result

[out] Pointer to a variable that receives a boolean value that determines whether this region is empty (TRUE) or not (FALSE).

GdipIsEqualRegion

Description

Determines whether this region is equal to a specified region.

Syntax

GpStatus WINGDIPAPI GdipIsEqualRegion(

    GpRegion *region,

    GpRegion *region2,

    GpGraphics *graphics,

    BOOL *result

);

PowerBASIC Syntax

DECLARE FUNCTION GdipIsEqualRegion ( _

    BYVAL region AS DWORD, _

    BYVAL region2 AS DWORD, _

    BYVAL graphics AS DWORD, _

    BYREF result AS LONG _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

region2

[in] Pointer to a Region object to test against this Region object.

graphics

[in] Pointer to a Graphics object that contains the world and page transformations required to calculate the device coordinates of this region and the region that is specified by the region parameter.

result

[out] Pointer to a variable that receives a boolean value that determines whether this region is equal to a specified region (TRUE) or not (FALSE).

GdipIsInfiniteRegion

Description

Determines whether this region is infinite.

Syntax

GpStatus WINGDIPAPI GdipIsInfiniteRegion(

    GpRegion *region,

    GpGraphics *graphics,

    BOOL *result

);

PowerBASIC Syntax

DECLARE FUNCTION GdipIsInfiniteRegion ( _

    BYVAL region AS DWORD, _

    BYVAL graphics AS DWORD, _

    BYREF result AS LONG _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

graphics

[in] Pointer to a Graphics object that contains the world and page transformations required to calculate the device coordinates of this region.

result

[out] Pointer to a variable that receives a boolean value that determines whether this region is infinite (TRUE) or not (FALSE).

GdipIsVisibleRegionPoint

Description

Determines whether a point is inside this region.

Syntax

GpStatus WINGDIPAPI GdipIsVisibleRegionPoint(

    GpRegion *region,

    REAL x,

    REAL y,

    GpGraphics *graphics,

    BOOL *result

);

PowerBASIC Syntax

DECLARE FUNCTION GdipIsVisibleRegionPoint ( _

    BYVAL region AS DWORD, _

    BYVAL x AS SINGLE, _

    BYVAL y AS SINGLE, _

    BYVAL graphics AS DWORD, _

    BYREF result AS LONG _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

x

[in] Single precision value that specifies the x-coordinate of the point to test.

y

[in] Single precision value that specifies the y-coordinate of the point to test.

graphics

[in] Pointer to a Graphics object that contains the world and page transformations required to calculate the device coordinates of this region and the point. The default value is NULL.

result

[out] Pointer to a variable that receives a boolean value that determines whether a point is inside this region (TRUE) or not (FALSE).

GdipIsVisibleRegionPointI

Description

Determines whether a point is inside this region.

Syntax

GpStatus WINGDIPAPI GdipIsVisibleRegionPointI(

    GpRegion *region,

    INT x,

    INT y,

    GpGraphics *graphics,

    BOOL *result

);

PowerBASIC Syntax

DECLARE FUNCTION GdipIsVisibleRegionPointI ( _

    BYVAL region AS DWORD, _

    BYVAL x AS LONG, _

    BYVAL y AS LONG, _

    BYVAL graphics AS DWORD, _

    BYREF result AS LONG _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

x

[in] Long integer value that specifies the x-coordinate of the point to test.

y

[in] Long integer value that specifies the y-coordinate of the point to test.

graphics

[in] Pointer to a Graphics object that contains the world and page transformations required to calculate the device coordinates of this region and the point. The default value is NULL.

result

[out] Pointer to a variable that receives a boolean value that determines whether a point is inside this region (TRUE) or not (FALSE).

GdipIsVisibleRegionRect

Description

Determines whether a rectangle intersects this region.

Syntax

GpStatus WINGDIPAPI GdipIsVisibleRegionRect(

    GpRegion *region,

    REAL x,

    REAL y,

    REAL width,

    REAL height,

    GpGraphics *graphics,

    BOOL *result

);

PowerBASIC Syntax

DECLARE FUNCTION GdipIsVisibleRegionRect ( _

    BYVAL region AS DWORD, _

    BYVAL x AS SINGLE, _

    BYVAL y AS SINGLE, _

    BYVAL nWidth AS SINGLE, _

    BYVAL nHeight AS SINGLE, _

    BYVAL graphics AS DWORD, _

    BYREF result AS LONG _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

x

[in] Single precision value that specifies the x-coordinate of the upper-left corner of the rectangle to test.

y

[in] Single precision value that specifies the y-coordinate of the upper-left corner of the rectangle to test.

width

[in] Single precision value that specifies the width of the rectangle to test.

height

[in] Single precision value that specifies the height of the rectangle to test.

graphics

[in] Pointer to a Graphics object that contains the world and page transformations required to calculate the device coordinates of this region and the rectangle. The default value is NULL.

result

[out] Pointer to a variable that receives a boolean value that determines whether a rectangle intersects this region (TRUE) or not (FALSE).

GdipIsVisibleRegionRectI

Description

Determines whether a rectangle intersects this region.

Syntax

GpStatus WINGDIPAPI GdipIsVisibleRegionRectI(

    GpRegion *region,

    INT x,

    INT y,

    INT width,

    INT height,

    GpGraphics *graphics,

    BOOL *result

);

PowerBASIC Syntax

DECLARE FUNCTION GdipIsVisibleRegionRectI ( _

    BYVAL region AS DWORD, _

    BYVAL x AS LONG, _

    BYVAL y AS LONG, _

    BYVAL nWidth AS LONG, _

    BYVAL nHeight AS LONG, _

    BYVAL graphics AS DWORD, _

    BYREF result AS LONG _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

x

[in] Single precison value that specifies the x-coordinate of the upper-left corner of the rectangle to test.

y

[in] Single precison value that specifies the y-coordinate of the upper-left corner of the rectangle to test.

width

[in] Single precison value that specifies the width of the rectangle to test.

height

[in] Integer number that specifies the height of the rectangle to test.

graphics

[in] Pointer to a Graphics object that contains the world and page transformations required to calculate the device coordinates of this region and the rectangle. The default value is NULL.

result

[out] Pointer to a variable that receives a boolean value that determines whether a rectangle intersects this region (TRUE) or not (FALSE).

GdipSetEmpty

Description

Updates this region to an empty region. In other words, the region occupies no space on the display device.

Syntax

GpStatus WINGDIPAPI GdipSetEmpty(

    GpRegion *region

);

PowerBASIC Syntax

DECLARE FUNCTION GdipSetEmpty ( _

    BYVAL region AS DWORD _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

GdipSetInfinite

Description

Updates this region to an infinite region.

Syntax

GpStatus WINGDIPAPI GdipSetInfinite(

    GpRegion *region

);

PowerBASIC Syntax

DECLARE FUNCTION GdipSetInfinite ( _

    BYVAL region AS LONG _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

GdipTransformRegion

Description

Transforms this region by multiplying each of its data points by a specified matrix.

Syntax

GpStatus WINGDIPAPI GdipTransformRegion(

    GpRegion *region,

    GpMatrix *matrix

);

PowerBASIC Syntax

DECLARE FUNCTION GdipTransformRegion ( _

    BYVAL region AS DWORD, _

    BYVAL matrix AS DWORD _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

matrix

[in] Pointer to a matrix that specifies the transformation.

GdipTranslateRegion

Description

Offsets this region by specified amounts in the horizontal and vertical directions.

Syntax

GpStatus WINGDIPAPI GdipTranslateRegion(

    GpRegion *region,

    REAL dx,

    REAL dy

);

PowerBASIC Syntax

DECLARE FUNCTION GdipTranslateRegion ( _

    BYVAL region AS DWORD, _

    BYVAL dx AS SINGLE, _

    BYVAL dy AS SINGLE _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

dx

[in] Single precision value that specifies the amount to shift the region in the x direction.

dy

[in] Single precision value that specifies the amount to shift the region in the y direction.

GdipTranslateRegionI

Description

Offsets this region by specified amounts in the horizontal and vertical directions.

Syntax

GpStatus WINGDIPAPI GdipTranslateRegionI(

    GpRegion *region,

    INT dx,

    INT dy

);

PowerBASIC Syntax

DECLARE FUNCTION GdipTranslateRegionI ( _

    BYVAL region AS DWORD, _

    BYVAL dx AS LONG, _

    BYVAL dy AS LONG _

) AS LONG

Parameters

region

[in] Pointer to the Region object.

dx

[in] Integer number that specifies the amount to shift the region in the x direction.

dy

[in] Integer number that specifies the amount to shift the region in the y direction.