Выбрать главу

Приложение регистрирует функцию LineDDAProc , передавая ее адрес в функцию LineDDA.

Требования

Windows NT/2000/XP: Включена в Windows NT 3.1 и выше.

Windows 95/98/Me: Включена в Windows 95 и выше.

Заголовок: Объявлена в Wingdi.h; подключать Windows.h.

См. также

LineDDA.

LineTo

Функция LineTo рисует линию из текущей позиции до указанной точки, не включая ее.

BOOL LineTo (

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

int nXEnd , // x -координата завершающей линию точки

int nYEnd // y - координата завершающей линию точки

);

Параметры

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

nXEnd - определяет x -координату завершающей линию точки.

nYEnd - определяет y -координату завершающей линию точки.

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

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

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

Комментарии

Координаты завершающей точки линии указываются в логических единицах.

Линия рисуется текущим пером, и, если перо является геометрическим пером, текущей кистью.

В случае успеха LineTo , текущая позиция устанавливается в указанную завершающую точку.

См. также

MoveToEx, Polyline, PolylineTo .

MoveToEx

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

BOOL MoveToEx (

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

int X , // x -координата новой текущей позиции

int Y , // y - координата новой текущей позиции

LPPOINT lpPoint // адрес старой текущей позиции

);

Параметры

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

X - определяет x -координату новой текущей позиции в логических единицах.

Y - определяет y -координату новой текущей позиции в логических единицах.

lpPoint - указывает на структуру типа POINT , в которой хранится предыдущая текущая позиция. Если значение этого параметра равно NULL, предыдущая позиция не возвращается.

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

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

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

Комментарии

Функция MoveToEx воздействует на все функции рисования.

См. также

AngleArc, LineTo, POINT, PolyBezierTo, PolylineTo .

Polyline

Функция Polyline рисует серию отрезков прямых, соединяя точки в указанном массиве.

BOOL Polyline (

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

CONST POINT * lppt , // адрес массива с точками

int cPoints // количество точек в массиве

);

Параметры

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

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

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 для соответствующей полилинии. Значение каждого элемента должно быть больше или равно двум.