AngleArc 函式 (wingdi.h)

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 函式會將目前的位置移至弧線的結束點。

根據目前的轉換和對應模式，此函式所繪製的弧形可能為橢圓形。在繪製弧形之前， AngleArc 會從目前位置繪製線條線段到弧線的開頭。

弧形是藉由建構指定的中心點周圍加上指定半徑的虛圓來繪製。弧線的起點取決於從圓形的 X 軸以開始角度的度數來測量反時針。結束點同樣地是藉由從掃掠角度的度數開始，以反時針點來測量。

如果掃掠角度大於 360 度，則弧形會多次掃掠。

此函式會使用目前的畫筆繪製線條。此圖未填滿。

如需範例，請參閱繪製餅圖。