createRectRgn

Syntax

region createRectRgn(int x1, int y1, int x2, int y2)

Arguments

x1
The x coordinate (in DBUs) of the upper-left edge of the rectangle.
y1
The y coordinate (in DBUs) of the upper-left edge of the rectangle.
x2
The x coordinate (in DBUs) of the lower-right edge of the rectangle.
y2
The y coordinate (in DBUs) of the lower-right edge of the rectangle.

Return

Return a rectangular region (see comments)

Description

Allows to define a rectangular visual region, that can be for instance handled by the functions refreshRgn or setDialogRegion

Example

refreshRgn( createRectRgn(215,30,410,250) ); 

Also see

createRoundRectRgn, createCircularRgn, createEllipticRgn, createPolyRgn, refreshRgn, setDialogRegion

Comments

"region" correspond to a particular FM type or object that might need to be better documented or defined. You can't directly cast it to an integer, despite it behaves like an integer.

Everyone can add his comments about his experiences with this function here. Tips for using it are welcome, too.