Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

RectVisible function

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 *lprc
);

Parameters

hdc [in]

A handle to the device context.

lprc [in]

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.

Examples

For an example, see Redrawing in the Update Region.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Wingdi.h (include Windows.h)

Library

Gdi32.lib

DLL

Gdi32.dll

See also

Clipping Overview
Clipping Functions
CreateRectRgn
PtVisible
RECT
SelectClipRgn

 

 

Show: