# SetRectEmpty Function

`Declare Function SetRectEmpty Lib "user32.dll" (lpRect As RECT) As Long`

SetRectEmpty sets a rectangle to an empty state. An empty rectangle is one that has a nonpositive width and/or height. In this case, Windows sets the rectangle to (0,0)-(0,0). The function returns 0 if an error occured, or a non-zero value if successful.

lpRect
  The rectangle to set as empty.

Example:

    ' Set rectangle r to an empty state
    Dim r As RECT
    x = SetRectEmpty(r)  ' r = (0,0)-(0,0)

Related Calls: IsRectEmpty, SetRect
Category: Rectangles
Back to the index.