Функция PolylineTo рисует одну или несколько прямых линий.
Синтаксис
BOOL PolylineTo( HDC hdc, // дескриптор контекста устройства CONST POINT *lppt, // массив точек DWORD cCount // число точек в массиве ); |
hdc
[in] Дескриптор контекста устройства.
lppt
[in] Указатель на массив структур POINT, который содержит узлы линии, в логических единицах.
cCount
[in] Определяет число точек в массиве.
Если функция завершается успешно, возвращаемое значение - не нуль.
Если функция завершается ошибкой, возвращаемое значение - нуль.
Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
В отличие от функции Polyline, функция PolylineTo использует и модернизирует текущую позицию.
Линия рисуется от текущей позиции до первой точки, определенной параметром lppt при помощи использования текущего пера. Для каждой дополнительной линии, функция рисует от конечной точки предыдущей линии к следующей точке, определенной lppt.
Функция PolylineTo перемещает текущую позицию в конечную точку последней линии.
Если отрезки прямых, рисуемые этой функцией формируют закрытую фигуру, фигура не закрашивается.
Windows 95/98/Me: функция PolylineTo не может рисовать более чем определенное число точек. Ограничение зависит от ширины линии (то есть, ширины пера, выбранного в контекст устройства (DC)), как показано в нижеследующей таблице.
| Ширина линии | Максимально разрешенное число точек |
|---|---|
| ширина линии - 1 | 16K |
| ширина линии> 1 (то есть, толстая линия) и устройство поддерживает толстую линию | 16K |
| ширина линии> 1, но устройство не поддерживает толстую линию | приблизительно 1360 (то есть, приблизительно 16 КБ / 12) |
Любые дополнительные точки игнорируются. Чтобы начертить линию с большим количеством точек, разделите данные на группы, которые имеют меньше, а не максимальное число точек и вызывайте функцию для каждой группы точек. Не забудьте соединять отрезки прямых.
Смотри также
Обзор Линии и кривые, Функции, используемые линиями и кривыми, LineTo, MoveToEx, POINT, Polyline, PolyPolyline
|
Размещение и совместимость PolylineTo |
||
| К | Windows XP | Да |
| л | Windows 2000 Professional | Да |
| и | Windows NT Workstation | Да версии 3.1 и старше |
| е | Windows Me | Да |
| н | Windows 98 | Да |
| т | Windows 95 | Да |
| С | Windows Server 2003 | Да |
| е | Windows 2000 Server | Да |
| р | Windows NT Server | Да |
| в | ||
| е | ||
| р | ||
| Используемая библиотека | Gdi32.lib | |
| Используемая DLL | - | |
| Заголовочный файл | ||
| - объявлено в | Wingdi.h | |
| - включено в | Windows.h | |
| Unicode | Нет | |
| Замечания по платформе | Не имеется | |