Функция PolyPolyline

Функция 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 Нет
 Замечания по платформе Не имеется

 

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz