Функция PolylineTo

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

 

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

Hosted by uCoz