Функция Arc (wingdi.h)

Статья
03/08/2023

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

Синтаксис

BOOL Arc(
  [in] HDC hdc,
  [in] int x1,
  [in] int y1,
  [in] int x2,
  [in] int y2,
  [in] int x3,
  [in] int y3,
  [in] int x4,
  [in] int y4
);

Параметры

[in] hdc

Дескриптор контекста устройства, в котором выполняется рисование.

[in] x1

Координата X в логических единицах верхнего левого угла ограничивающего прямоугольника.

[in] y1

Координата Y в логических единицах верхнего левого угла ограничивающего прямоугольника.

[in] x2

Координата X в логических единицах правого нижнего угла ограничивающего прямоугольника.

[in] y2

Координата Y в логических единицах правого нижнего угла ограничивающего прямоугольника.

[in] x3

Координата X в логических единицах конечной точки радиальной линии, определяющей начальную точку дуги.

[in] y3

Координата Y в логических единицах конечной точки радиальной линии, определяющей начальную точку дуги.

[in] x4

Координата X в логических единицах конечной точки радиальной линии, определяющей конечную точку дуги.

[in] y4

Координата Y в логических единицах конечной точки радиальной линии, определяющей конечную точку дуги.

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

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

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

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

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

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

Используйте функции GetArcDirection и SetArcDirection , чтобы получить и задать текущее направление рисования для контекста устройства. Направление рисования по умолчанию — против часовой стрелки.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll