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

開始角度に対するスイープ角度を度単位で指定します。

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。

AngleArc 関数は、現在の位置を円弧の終点に移動します。

この関数によって描画される円弧は、現在の変換とマッピングモードによっては楕円のように見える場合があります。円弧を描画する前に、 AngleArc は現在の位置から円弧の始点までの線分を描画します。

円弧は、指定した半径を持つ指定した中心点の周囲に虚数円を作成することによって描画されます。円弧の始点は、円の x 軸から開始角度の角度で反時計回りに測定することによって決定されます。終了点も同様に、始点からスイープ角度の角度の数だけ反時計回りに測定することによって配置されます。

スイープ角度が 360 度を超える場合、円弧は複数回スイープされます。

この関数は、現在のペンを使用して線を描画します。図が塗りつぶされていません。

例については、「円グラフの描画」を参照してください。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll