SetMetaRgn function (wingdi.h)
The SetMetaRgn function intersects the current clipping region for the specified device context with the current metaregion and saves the combined region as the new metaregion for the specified device context. The clipping region is reset to a null region.
Syntax
int SetMetaRgn(
[in] HDC hdc
);
Parameters
[in] hdc
A handle to the device context.
Return value
The return value specifies the new clipping region's complexity and can be one of the following values.
| Return code | Description |
|---|---|
|
Region is empty. |
|
Region is a single rectangle. |
|
Region is more than one rectangle. |
|
An error occurred. (The previous clipping region is unaffected.) |
Remarks
The current clipping region of a device context is defined by the intersection of its clipping region and its metaregion.
The SetMetaRgn function should only be called after an application's original device context was saved by calling the SaveDC function.
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 |