Функция SelectClipRgn выбирает регион как текущий регион отсечения для указанного контекста устройства.
Синтаксис
int SelectClipRgn( HDC hdc, // дескриптор DC HRGN hrgn // дескриптор региона ); |
hdc
[in] Дескриптор контекста устройства.
hrgn
[in] Дескриптор выбранного региона.
Возвращаемое значение задает сложность региона и может быть одним из следующих значений.
| Значение | Предназначение |
|---|---|
| NULLREGION | Регион - пустой. |
| SIMPLEREGION | Регион состоит из одного прямоугольника. |
| COMPLEXREGION | Регион состоит из больше чем один прямоугольник. |
| ERROR | Произошла ошибка . (Предыдущий регион отсечения не затронут.) |
Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Используется только копия выбранного региона . Сам регион может быть выбран для любого числа других контекстов устройства, или он может быть удален.
Функция SelectClipRgn предполагает, что координаты для региона определяются в единицах устройства.
Чтобы удалить регион отсечения контекста устройства, задайте дескриптор региона в значение ПУСТО (NULL).
Пример смотри в статье Отсечение вывода данных.
Смотри также
Обзор Отсечение, Функции, используемые отсечением, ExtSelectClipRgn
|
Размещение и совместимость SelectClipRgn |
||
| К | 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 | Нет | |
| Замечания по платформе | Не имеется | |