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

Статья
08/27/2023

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

Синтаксис

BOOL ArcTo(
  [in] HDC hdc,
  [in] int left,
  [in] int top,
  [in] int right,
  [in] int bottom,
  [in] int xr1,
  [in] int yr1,
  [in] int xr2,
  [in] int yr2
);

Параметры

[in] hdc

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

[in] left

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

[in] top

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

[in] right

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

[in] bottom

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

[in] xr1

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

[in] yr1

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

[in] xr2

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

[in] yr2

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

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

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

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

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

Линия отрисовывается от текущей позиции до начальной точки дуги. Если ошибка не возникает, текущая позиция устанавливается в конечную точку дуги.

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

Требования

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

См. также раздел

AngleArc

Arc

Функции линий и кривых

Общие сведения о линиях и кривых

SetArcDirection