Функция ExtSelectClipRgn


Функция ExtSelectClipRgn комбинирует указанный регион с текущим регионом отсечения, используя указанный метод.

Синтаксис

int ExtSelectClipRgn(
  HDC hdc,          // дескриптор DC
  HRGN hrgn,        // дескриптор региона
  int fnMode        // метод выбора региона
);

Параметры

hdc

[in] Дескриптор контекста устройства.

hrgn

[in] Дескриптор выбираемого региона. Этот дескриптор может быть значением только ПУСТО (NULL), когда определяется метод RGN_COPY.

fnMode

[in] Задает операцию, которая будет выполнена. Параметр должен быть одним из следующих значений.

Значение Предназначение
RGN_AND
Новый регион отсечения комбинируется с областью перекрытия текущего региона отсечения и региона, идентифицированного параметром hrgn.
RGN_COPY
Новый регион отсечения - копия региона, идентифицированного параметром hrgn. Он идентичен функции SelectClipRgn. Если регион, идентифицированный hrgn имеет значение ПУСТО (NULL), то новый регион отсечения имеет значение по умолчанию регион отсечения (значение по умолчанию региона отсечения равно нулевому региону).
RGN_DIFF
Новый регион отсечения комбинируется с областью текущего региона отсечения с теми областями, которые исключены из региона, идентифицированного параметром hrgn.
RGN_OR
Новый регион отсечения комбинирует текущий регион отсечения и регион, идентифицированный параметром hrgn.
RGN_XOR
Новый регион отсечения комбинируется с текущим регионом отсечения и регионом, идентифицированным параметром hrgn, но исключает любые области перекрытия.

Возвращаемые значения

Возвращаемое значение задает новую сложность региона отсечения; оно может быть одним из следующих значений.

Значение Предназначение
NULLREGION Регион пустой.
SIMPLEREGION Регион состоит из единственного прямоугольника.
COMPLEXREGION Регион состоит из более чем одного прямоугольника.
ERROR Произошла ошибка.

Замечания

Если ошибка происходит тогда, когда эту функцию вызывают, предыдущий регион отсечения для указанного контекста устройства не оказывает влияния.

Функция ExtSelectClipRgn предполагает, что координаты для указанного региона определяются в единицах устройства.

Используется только копия региона, идентифицированного параметром hrgn. Сам регион может многократно использоваться после того, как он вызван или мог быть удален.

Смотри также

Обзор Отсечение, Функции, используемые отсечением SelectClipRgn

Размещение и совместимость ExtSelectClipRgn  

К 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 Нет
 Замечания по платформе Не имеется

 

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz