Функция PolyPolyline рисует многократный ряд связанных отрезков прямых.
Синтаксис
BOOL PolyPolyline( HDC hdc, // дескриптор контекста устройства CONST POINT *lppt, // массив точек CONST DWORD *lpdwPolyPoints, // массив значений DWORD cCount // число записей в массиве значений ); |
hdc
[in] Дескриптор контекста устройства.
lppt
[in] Указатель на массив структур POINT, который содержит вершины ломаных линий, в логических единицах. Ломаные линии определяются последовательно.
lpdwPolyPoints
[in] Указатель на массив переменных, определяющих число точек в массиве lppt для соответствующей ломаной линии. Каждая запись должна быть больше или равна двум.
cCount
[in] Определяет общее количество записей в массиве lpdwPolyPoints.
Если функция завершается успешно, возвращаемое значение - не нуль.
Если функция завершается ошибкой, возвращаемое значение - нуль.
Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Отрезки прямых рисуются при помощи использования текущего пера. Фигуры, сформированные частями не закрашиваются.
Текущая позиция не используется и не обновляется этой функцией.
Windows 95/98/Me: функция PolyPolyline не может рисовать более чем определенное число точек. Ограничение зависит от ширины линии (то есть, ширины пера, выбранного в контекст устройства (DC)), как показано в нижеследующей таблице.
Ширина линии | Максимально разрешенное число точек |
---|---|
ширина линии - 1 | 16K |
ширина линии> 1 (то есть, толстая линия) и устройство поддерживает толстую линию | 16K |
ширина линии> 1, но устройство не поддерживает толстую линию | приблизительно 1360 (то есть, приблизительно 16 КБ / 12) |
Любые дополнительные точки игнорируются. Чтобы начертить линию с большим количеством точек, разделите данные на группы, которые имеют меньше, а не максимальное число точек и вызывайте функцию для каждой группы точек. Не забудьте соединять отрезки прямых.
Смотри также
Обзор Линии и кривые, Функции, используемые линиями и кривыми, POINT, Polyline, PolylineTo
Размещение и совместимость PolyPolyline |
||
К | 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 | Нет | |
Замечания по платформе | Не имеется |