RectVisible function (wingdi.h)

The RectVisible function determines whether any part of the specified rectangle lies within the clipping region of a device context.

Syntax

BOOL RectVisible(
  [in] HDC        hdc,
  [in] const RECT *lprect
);

Parameters

[in] hdc

A handle to the device context.

[in] lprect

A pointer to a RECT structure that contains the logical coordinates of the specified rectangle.

Return value

If the current transform does not have a rotation and the rectangle lies within the clipping region, the return value is TRUE (1).

If the current transform does not have a rotation and the rectangle does not lie within the clipping region, the return value is FALSE (0).

If the current transform has a rotation and the rectangle lies within the clipping region, the return value is 2.

If the current transform has a rotation and the rectangle does not lie within the clipping region, the return value is 1.

All other return values are considered error codes. If the any parameter is not valid, the return value is undefined.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wingdi.h (include Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

See also

Clipping Functions

Clipping Overview

CreateRectRgn

PtVisible

RECT

SelectClipRgn