Тарас Сорока - Русский справочник по Win32 API Страница 30

CONST DWORD * lpdwPolyPoints , // адрес массива значений

DWORD cCount // число элементов во втором массиве

);

Параметры

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

lppt - указатель на массив структур типа POINT . Каждая структура в массиве идентифицирует точку в логическом пространстве.

lpdwPolyPoints - указывает на массив переменных, определяющих число точек в массиве lppt для соответствующей полилинии. Значение каждого элемента должно быть больше или равно двум.

cCount - определяет количество элементов в массиве lpdwPolyPoints .

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

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

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

Комментарии

Отрезки прямых рисуются текущим пером. Фигуры, образованные сегментами, не закрашиваются.

Функция не использует и не обновляет текущую позицию.

См. также

POINT, Polyline, PolylineTo .

Отсечение

ExcludeClipRect

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

int ExcludeClipRect (

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

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

Комментарии

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

См. также

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 , // дескриптор контекста устройства

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

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

Комментарии