Русский справочник по Win32 API
Шрифт:
cPoints– определяет количество точек в массиве. Значение этого параметра должно быть больше или равно двум.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль.
Комментарии
Линии рисуются текущим пером с первой точки через последующие. В отличие от функции LineTo , функция Polyline не использует и не обновляет текущую позицию.
LineTo, MoveToEx, POINT, PolylineTo, PolyPolyline .
PolylineTo
Функция PolylineTo рисует серию отрезков прямых, соединяя точки в указанном массиве.
BOOL PolylineTo (
HDC hdc , // дескриптор контекста устройства
CONST POINT * lppt , // адрес массива с точками
int cPoints // количество точек в массиве
);
Параметры
hdc– идентифицирует контекст устройства.
lppt– указатель на массив структур типа POINT . Каждая структура в массиве идентифицирует точку в логическом пространстве.
cPoints– определяет количество точек в массиве.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль.
Комментарии
Отрезок рисуется текущим пером из текущей позиции до первой точки, указанной значением параметра lppt . Для каждого дополнительного отрезка функция рисует от завершающей точки предыдущего отрезка до следующей точки, указанной значением параметра lppt .
PolylineTo перемешает текущую позицию в завершающую точку последнего отрезка.
Если отрезки прямых, нарисованные функцией, образуют замкнутую фигуру, то она не закрашивается.
См. также
LineTo, MoveToEx, POINT, Polyline .
PolyPolyline
Функция PolyPolyline рисует множественные серии соединенных отрезков прямых.
BOOL PolyPolyline (
HDC hdc , // дескриптор контекста устройства
CONST POINT * lppt , // адрес массива с точками
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 -координату нижнего правого угла прямоугольника.
Возвращаемые значения
В случае успеха возвращаемое значение определяет сложность области и может быть одним из предопределенных значений: