CDC::ArcTo

[アーティクル]
08/09/2011

楕円の円弧を描画します。

BOOL ArcTo(
   int x1,
   int y1,
   int x2,
   int y2,
   int x3,
   int y3,
   int x4,
   int y4 
);
BOOL ArcTo(
   LPCRECT lpRect,
   POINT ptStart,
   POINT ptEnd 
);

パラメーター

x1
外接する四角形の左上隅の x 座標を指定します (論理単位)。
y1
外接する四角形の左上隅の y 座標を指定します (論理単位)。
x2
外接する四角形の右下隅の x 座標を指定します (論理単位)。
y2
外接する四角形の右下隅の y 座標を指定します (論理単位)。
x3
円弧の描画始点の x 座標 (論理単位)。この点は、正確に円弧の線上になくてもかまいません。
y3
円弧の描画始点の y 座標 (論理単位)。この点は、正確に円弧の線上になくてもかまいません。
x4
円弧の終点の x 座標 (論理単位)。この点は、正確に円弧の線上になくてもかまいません。
y4
円弧の終点の y 座標 (論理単位)。この点は、正確に円弧の線上になくてもかまいません。
lpRect
外接する四角形 (論理単位)。このパラメーターには、RECT 構造体または CRect オブジェクトを渡すことができます。
ptStart
円弧の描画始点の x 座標および y 座標 (論理単位)。この点は、正確に円弧の線上になくてもかまいません。このパラメーターには、POINT データ構造体または CPoint オブジェクトを渡すことができます。
ptEnd
円弧の描画終点の x 座標および y 座標 (論理単位)。この点は、正確に円弧の線上になくてもかまいません。パラメーターには、POINT 構造体または CPoint オブジェクトを渡すことができます。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

この関数は、現在位置を更新することを除いて CDC::Arc と同じです。点 (x1,y1) と点 (x2,y2) は、外接する四角形を指定します。楕円は、指定された円弧の曲線を定義する外接四角形で形成されます。円弧は、外接する四角形の中心から (x3,y3) に向かう半径の直線が交差する点から反時計回り (既定の円弧の方向) に展開されます。円弧の終点は、外接する四角形の中心から (x4,y4) に向かう半径の直線が交差する点になります。始点と終点が同じ場合は、完全な楕円が描画されます。

現在位置から円弧の始点に向かう直線が描画されます。エラーが発生しない場合は、現在位置は円弧の終点になります。円弧は現在のペンを使って描画され、塗りつぶされません。