| int GetClipBox(hdc, lprc) | |||||
| HDC hdc; | /* handle of the device-context | */ | |||
| LPRECT lprc; | /* address of structure with rectangle | */ | |||
The GetClipBox function retrieves the dimensions of the tightest bounding rectangle that can be drawn around the current visible area on the device. The visible area is defined by the current clip-region and clip-path, as well as overlapping windows.
hdc
Identifies the device context.
lprc
Points to a RECT structure that is to receive the rectangle dimensions. The RECT structure has the following format:
typedef struct tagRECT { /* rc */
LONG left;
LONG top;
LONG right;
LONG bottom;
} RECT;
The return value specifies the clipping box's complexity if the function is successful. It can be any one of the following values:
| Value | Meaning |
| NULLREGION | Region is empty. |
| SIMPLEREGION | Region is a single rectangle. |
| COMPLEXREGION | Region is more than a single rectangle. |
| ERROR |
RECT