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 идентифицирует копию текущей метаобласти. Последующие изменения этой копии не повлияют на текущую метаобласть.