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

Статья
08/27/2023

Функция AngleArc рисует сегмент линии и дугу. Сегмент линии отрисовывается от текущей позиции до начала дуги. Дуга рисуется по периметру окружности с заданным радиусом и центром. Длина дуги определяется заданными углами начала и развертки.

Синтаксис

BOOL AngleArc(
  [in] HDC   hdc,
  [in] int   x,
  [in] int   y,
  [in] DWORD r,
  [in] FLOAT StartAngle,
  [in] FLOAT SweepAngle
);

Параметры

[in] hdc

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

[in] x

Задает координату по оси X (в логических единицах) центра окружности.

[in] y

Задает координату Y в логических единицах центра окружности.

[in] r

Указывает радиус (в логических единицах) окружности. Это значение должно быть положительным.

[in] StartAngle

Задает начальный угол в градусах относительно оси X.

[in] SweepAngle

Задает угол развертки в градусах относительно начального угла.

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

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

Если функция выполняется неудачно, возвращается нулевое значение.

Дуга, рисуемая этой функцией, может показаться эллиптической в зависимости от текущего режима преобразования и сопоставления. Перед рисованием дуги AngleArc рисует сегмент линии от текущего положения до начала дуги.

Дуга рисуется путем построения воображаемого круга вокруг указанной центральной точки с заданным радиусом. Начальная точка дуги определяется измерением против часовой стрелки от оси X окружности по количеству градусов в начальном углу. Конечная точка находится аналогично путем измерения против часовой стрелки от начальной точки по количеству градусов в углу развертки.

Если угол развертки больше 360 градусов, дуга заметается несколько раз.

Эта функция рисует линии с помощью текущего пера. Рисунок не заполнен.

Примеры

Пример см. в разделе Рисование круговой диаграммы.

Требования

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