Функция Arc


Функция Arc рисует эллиптическую дугу.

Синтаксис

BOOL Arc(
  HDC hdc,         // дескриптор контекста устройства
  int nLeftRect,   // x-координата левого верхнего угла прямоугольника
  int nTopRect,    // y-координата левого верхнего угла прямоугольника
  int nRightRect,  // x-координата нижнего правого угла прямоугольника
  int nBottomRect, // y-координата нижнего правого угла прямоугольника
  int nXStartArc,  // x-координата первой радиальной конечной точки
  int nYStartArc,  // y-координата первой радиальной конечной точки
  int nXEndArc,    // x-координата второй радиальной конечной точки
  int nYEndArc     // y-координата второй радиальной конечной точки
);

Параметры

hdc

[in] Дескриптор контекста устройства, в котором операция рисования получила место.

nLeftRect

[in] Задает x-координату левого верхнего угла ограничивающего прямоугольника, в логических единицах.

Windows 95/98/Me: Сумма nLeftRect плюс nRightRect должна быть меньше чем 32768.

nTopRect

[in] Задает y-координату левого верхнего угла ограничивающего прямоугольника, в логических единицах.

Windows 95/98/Me: Сумма nTopRect плюс nBottomRect должна быть меньше чем 32768.

nRightRect

[in] Задает x-координату нижнего правого угла ограничивающего прямоугольника, в логических единицах.

Windows 95/98/Me: Сумма nLeftRect плюс nRightRect должна быть меньше чем 32768. 

nBottomRect

[in] Задает y-координату нижнего правого угла ограничивающего прямоугольника, в логических единицах.

Windows 95/98/Me: Сумма nTopRect плюс nBottomRect должна быть меньше чем 32768.

nXStartArc

[in] Задает x-координату конечной точки радиальной линии, определяющей начальную точку дуги, в логических единицах.

nYStartArc

[in] Задает y-координату конечной точки радиальной линии, определяющей начальную точку дуги, в логических единицах.

nXEndArc

[in] Задает x-координату конечной точки радиальной линии, определяющей конечную точку дуги, в логических единицах.

nYEndArc

[in] Задает y-координату конечной точки радиальной линии, определяющей конечную точку дуги, в логических единицах.

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

Если дуга рисуется, возвращаемое значение является ненулевым.

Если дуга не рисуется, возвращаемое значение - нуль.

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

Замечания

Точки (nLeftRect, nTopRect) и (nRightRect, nBottomRect) задают ограничивающий прямоугольник. Эллипс, сформированный указанным ограничивающим прямоугольником определяет кривую дуги. Дуга разворачивается в области текущего рисунка от точки, где она пересекает радиальную линию центра ограничивающего прямоугольника до (nXStartArc, nYStartArc) точки. Дуга заканчивается там, где она пересекает радиальную линию от центра ограничивающего прямоугольника до (nXEndArc, nYEndArc) точки. Если начальная и конечная точка имеют ту же самую величину, то рисуется полный эллипс.

Дуга рисуется, используя текущее перо; она не закрашивается.

Текущее положение не используется, не обновляется функцией Arc.

Windows 95/98/Me: Направление рисования - всегда против часовой стрелки.

Windows NT/2000/XP: Используйте функции GetArcDirection и SetArcDirection, чтобы получить и установить направление текущего рисунка для контекста устройства. Значение по умолчанию направление рисования - против часовой стрелки.

Windows 95/98/Me: Сумма координат ограничивающего прямоугольника не может превысить 32 767. Сумма nLeftRect и nRightRect или nTopRect и nBottomRect параметров не может превысить 32 767.

Смотри также

Обзор Линии и кривые, Функции, используемые линиями и кривымиAngleArc, ArcTo, Chord, Ellipse, GetArcDirection, Pie, SetArcDirection

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

К 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