arc 函式 (wingdi.h)

發行項
03/13/2024

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)
程式庫	Gdi32.lib
Dll	Gdi32.dll