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

VOID CALLBACK LineDDAProc(

int X , // x -координата точки

int Y , // у-координата точки

LPARAM lpData // определяемые приложением данные

);

Параметры

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

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

lpData - указатель на определяемые приложением данные.

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

Функция не возвращает значения.

Комментарии

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

Требования

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

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

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

См . также

LineDDA.

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

BOOL LineTo(

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

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

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

);

Параметры

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

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

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

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

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

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

Комментарии

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

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

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

См. также

MoveToEx, Polyline, PolylineTo.

Функция 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рисует серию отрезков прямых, соединяя точки в указанном массиве.

BOOL Polyline(

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

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

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

);

Параметры

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

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

cPoints - определяет количество точек в массиве. Значение этого параметра должно быть больше или равно двум.

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

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

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

Комментарии

Линии рисуются текущим пером с первой точки через последующие. В отличие от функции LineTo, функция Polylineне использует и не обновляет текущую позицию.

См. также

LineTo, MoveToEx, POINT, PolylineTo, PolyPolyline.

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

BOOL PolylineTo(

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

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

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

);

Параметры

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

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

cPoints - определяет количество точек в массиве.

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

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

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

Комментарии

Отрезок рисуется текущим пером из текущей позиции до первой точки, указанной значением параметра lppt . Для каждого дополнительного отрезка функция рисует от завершающей точки предыдущего отрезка до следующей точки, указанной значением параметра lppt .

PolylineToперемешает текущую позицию в завершающую точку последнего отрезка.

Если отрезки прямых, нарисованные функцией, образуют замкнутую фигуру, то она не закрашивается.

См. также

LineTo, MoveToEx, POINT, Polyline.

Функция PolyPolylineрисует множественные серии соединенных отрезков прямых.

BOOL PolyPolyline(

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

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

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

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

);

Параметры

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

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

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

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

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

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

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

Комментарии

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

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

См. также

POINT, Polyline, PolylineTo.

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