Русский справочник по Win32 API

В случае успеха возвращается ненулевое значение.

В случае неудачи возвращается нуль.

Комментарии

В случае успеха значение hrgn идентифицирует копию текущей метаобласти. Последующие изменения этой копии не повлияют на текущую метаобласть.

Текущая область отсечения контекста устройства определяется пересечением его области отсечения и его метаобласти.

См. также

SetMetaRgn .

IntersectClipRect

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

int IntersectClipRect (

HDC hdc , // дескриптор контекста устройства

int nLeftRect , // x -координата верхнего левого угла прямоугольника

int nTopRect , // y -координата верхнего левого угла прямоугольника

int nRightRect , // x -координата нижнего правого угла прямоугольника

int nBottomRect // y -координата нижнего правого угла прямоугольника

);

Параметры

hdc - идентифицирует контекст устройства.

nLeftRect - идентифицирует логическую x -координату верхнего левого угла прямоугольника.

nTopRect - идентифицирует логическую y -координату верхнего левого угла прямоугольника.

nRightRect - идентифицирует логическую x -координату нижнего правого угла прямоугольника.

nBottomRect - идентифицирует логическую y -координату нижнего правого угла прямоугольника.

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

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

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

Комментарии

Нижняя и правая грани указанного прямоугольника исключаются из области отсечения.

См . также

ExcludeClipRect .

OffsetClipRgn

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

int OffsetClipRgn (

HDC hdc , // дескриптор контекста устройства

int nXOffset , // смещение вдоль оси x

int nYOffset // смещение вдоль оси y

);

Параметры

hdc - идентифицирует контекст устройства.

nXOffset - определяет количество логических единиц для перемещения влево или вправо.

nYOffset - определяет количество логических единиц для перемещения вверх или вниз.

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

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

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

См. также

SelectClipRgn .

SelectClipPath

Функция SelectClipPath выбирает текущий путь ( path ) в качестве области отсечения для контекста устройства, объединяя новую область отсечения с существующей, используя указанный режим.

BOOL SelectClipPath

(

HDC hdc , // дескриптор контекста устройства

int iMode // режим отсечения

);

Параметры

hdc - идентифицирует контекст устройства пути.

iMode - определяет способ использования пути. Допустимы следующие значения:

Значение	Пояснение
RGN _ AND	Новая область отсечения включает пересечение (перекрывающиеся участки) текущей области отсечения и текущего пути.
RGN _ COPY	Новой областью отсечения является текущий путь.
RGN _ DIFF	Новая область отсечения включает участки текущей области отсечения и участки, исключенные из текущего пути.
RGN _ OR	Новая область отсечения представляет собой объединение текущей области отсечения и текущего пути.
RGN _ XOR	Новая область отсечения включает в себя объединение текущей области отсечения и текущего пути, но без пересекающихся участков.

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

В случае успеха возвращается ненулевое значение.