Windows API Guide: CHOOSEFONT_TYPE Structure

---

Declare Function CreateRectRgn Lib "gdi32.dll" (ByVal X1 As Long, ByVal Y1 As Long, ByVal X2 As Long, ByVal Y2 As Long) As Long

Platforms: Win 32s, Win 95/98, Win NT

CreateRectRgn creates a rectangularly-shaped region and provides a handle to it. The rectangle defining the region is specified by passing its upper-left and lower-right corners to the function. Note that the bottom and right edges of the rectangle are not considered to be part of the region. The function returns a handle to the newly created region if successful, or 0 if an error occured.

X1

The x-coordinate of the upper-left corner of the rectangle.

Y1

The y-coordinate of the upper-left corner of the rectangle.

X2

The x-coordinate of the lower-right corner of the rectangle.

Y2

The y-coordinate of the lower-right corner of the rectangle.

Example:

' Invert the pixels within a rectangular region on window Form1.  The region ' has corners (20,30)-(150,110). Dim hrgn As Long  ' handle to the rectangular region Dim retval As Long  ' return value ' Create the rectangular region and get a handle to it. hrgn = CreateRectRgn(20, 30, 150, 110)  ' has corners (20,30)-(150,110) ' Invert the pixels on Form1 within this region. retval = InvertRgn(Form1.hDC, hrgn) ' Delete the region to free up resources. retval = DeleteObject(hrgn)

See Also: CreateRectRgnIndirect, CreateRoundRectRgn
Category: Regions

Go back to the alphabetical Function listing.
Go back to the Reference section index.

---

This page is copyright © 2000 Paul Kuliniewicz. Copyright Information.
Go back to the Windows API Guide home page.
E-mail: [e-mail] Send Encrypted E-Mail
This page is at http://www.vbapi.com/ref/c/createrectrgn.html