Функция аккорда (wingdi.h)

Статья
03/08/2023

Функция Аккорд рисует аккорд (область, ограниченную пересечением эллипса и сегмента линии, называемого секантом). Аккорд задается с помощью текущего пера и заполняется с помощью текущей кисти.

Синтаксис

BOOL Chord(
  [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 в логических координатах конечной точки радиального элемента, определяющего конец аккорда.

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

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

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

Кривая аккорда определяется эллипсом, который соответствует указанному ограничивающему прямоугольнику. Кривая начинается в точке, где эллипс пересекает первый радиальный и расширяется против часовой стрелки до точки, где эллипс пересекается со вторым радиальным. Аккорд закрывается путем рисования линии от пересечения первого радиала и кривой до пересечения второго радиала и кривой.

Если начальная и конечная точки кривой совпадают, рисуется полный эллипс.

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

Требования


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