Функция Polyline

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

Синтаксис

BOOL Polyline(
  HDC hdc,            // дескриптор контекста устройства
  CONST POINT *lppt,  // массив конечных точек
  int cPoints         // число точек в массиве
);

Параметры

hdc

[in] Дескриптор контекста устройства.

lppt

[in] Указатель на массив структур POINT, в логических единицах.

cPoints

[in] Определяет число точек в массиве. Это число должно быть больше или равно двум.

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

Если функция завершается успешно, возвращаемое значение - не нуль.

Если функция завершается ошибкой, возвращаемое значение - нуль.

Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Замечания

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

Windows 95/98/Me: функция Polyline не может рисовать более чем определенное число точек. Ограничение зависит от ширины линии (то есть, ширины пера, выбранного в контекст устройства (DC)), как показано в нижеследующей таблице.

Ширина линии Максимально разрешенное число точек
ширина линии - 1 16K
ширина линии> 1 (то есть, толстая линия) и устройство поддерживает толстую линию 16K
ширина линии> 1, но устройство не поддерживает толстую линию приблизительно 1360 (то есть, приблизительно 16 КБ / 12)
 

Любые дополнительные точки игнорируются. Чтобы начертить линию с большим количеством точек, разделите данные на группы, которые имеют меньше, а не максимальное число точек и вызывайте функцию для каждой группы точек. Не забудьте соединять отрезки прямых.

Смотри также

Обзор Линии и кривые, Функции, используемые линиями и кривымиLineTo, MoveToEx, POINT, PolylineTo, PolyPolyline

Размещение и совместимость Polyline   

К 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