Функция SetMetaRgn перекрывает текущий регион отсечения для указанного контекста устройства с текущим метарегионом и сохраняет объединенный регион как новый метарегион для указанного контекста устройства. Регион отсечения сбрасывается в нулевой регион.
Синтаксис
int SetMetaRgn( HDC hdc // дескриптор DC ); |
hdc
[in] Дескриптор контекста устройства.
Возвращаемое значение задает сложность нового региона отсечения и может быть одним из следующих значений.
| Значение | Предназначение |
|---|---|
| NULLREGION | Регион - пустой. |
| SIMPLEREGION | Регион состоит из одного прямоугольника. |
| COMPLEXREGION | Регион состоит из больше чем один прямоугольник. |
| ERROR | Произошла ошибка . (Предыдущий регион отсечения не затронут.) |
Текущий регион отсечения контекста устройства определяется пересечением его региона отсечения и его метарегиона.
Функцию SetMetaRgn вызвать нужно только после того, как исходный контекст устройства приложения сохраниться, путем вызова функции SaveDC.
Смотри также
Обзор Отсечение, Функции, используемые отсечением, GetMetaRgn, SaveDC
|
Размещение и совместимость SetMetaRgn |
||
| К | Windows XP | Да |
| л | Windows 2000 Professional | Да |
| и | Windows NT Workstation | Да версии 3.1 и старше |
| е | Windows Me | Да |
| н | Windows 98 | Да |
| т | Windows 95 | Да |
| С | Windows Server 2003 | Нет |
| е | Windows 2000 Server | Да |
| р | Windows NT Server | Да |
| в | ||
| е | ||
| р | ||
| Используемая библиотека | Gdi32.lib | |
| Используемая DLL | - | |
| Заголовочный файл | ||
| - объявлено в | Wingdi.h | |
| - включено в | Windows.h | |
| Unicode | Нет | |
| Замечания по платформе | Не имеется | |