arc 函数 (wingdi.h)

项目
08/27/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
标头	wingdi.h (包括 Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll