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

Сорока Тарас

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

См. также

IntersectClipRect .

GetClipBox

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

областью отсечения или путем ( path ) отсечения, так же, как и любые перекрывающиеся окна.

int GetClipBox (

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

LPRECT lprc // адрес структуры с прямоугольником

);

Параметры

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

lprc– указывает на структуру типа RECT , которая предназначена для получения размеров прямоугольника.

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

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

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

GetClipBox возвращает логические координаты, основанные на текущем контексте устройства.

См. также

RECT .

GetClipRgn

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

int GetClipRgn (

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

HRGN hrgn // дескриптор области

);

Параметры

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

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

идентифицирует копию текущей области отсечения.

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

В случае успеха и если для указанного контекста устройства отсутствует область отсечения, возвращается нуль. В случае успеха и если для указанного контекста устройства существует область отсечения, возвращается 1.

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

Комментарии

Определяемая приложением область отсечения - это область, идентифицируемая функцией SelectClipRgn . Это не область отсечения, созданная вызовом функции BeginPaint .

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

См. также

BeginPaint, SelectClipRgn .

GetMetaRgn

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

int GetMetaRgn (

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

HRGN hrgn // дескриптор области

);

Параметры

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

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

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

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

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

Комментарии

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

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

См. также

SetMetaRgn .

IntersectClipRect

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

int IntersectClipRect (

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