CRgn::CreateEllipticRgn

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

楕円領域を作成します。

BOOL CreateEllipticRgn(
   int x1,
   int y1,
   int x2,
   int y2 
);

パラメーター

x1
楕円に外接する四角形の左上隅の論理 x 座標を指定します。
y1
楕円に外接する四角形の左上隅の論理 y 座標を指定します。
x2
楕円に外接する四角形の右下隅の論理 x 座標を指定します。
y2
楕円に外接する四角形の右下隅の論理 y 座標を指定します。

戻り値

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

解説

領域は、x1、y1、x2、および y2 で指定された外接四角形で定義されます。領域は CRgn オブジェクトに格納されます。

領域のサイズは、論理単位で 32,767 × 32,767、または 64K のメモリのいずれか小さい方で制限されます。

CreateEllipticRgn 関数で作成された領域を使い終わったときは、その領域をデバイスコンテキストから選択解除し、DeleteObject 関数を使って領域を削除します。

使用例

CRgn   rgnA, rgnB, rgnC;

VERIFY(rgnA.CreateEllipticRgn(200, 100, 350, 250));
VERIFY(rgnB.CreateRectRgn( 0, 0, 50, 50 ));
VERIFY(rgnB.CopyRgn( &rgnA ));
int nOffsetResult = rgnB.OffsetRgn( -75, 75 );
ASSERT( nOffsetResult != ERROR && nOffsetResult != NULLREGION );

VERIFY(rgnC.CreateRectRgn( 0, 0, 1, 1));
int nCombineResult = rgnC.CombineRgn( &rgnA, &rgnB, RGN_AND );
ASSERT( nCombineResult != ERROR && nOffsetResult != NULLREGION );

CBrush brA, brB, brC;
VERIFY(brC.CreateHatchBrush( HS_FDIAGONAL, RGB(0, 0, 255) )); // Blue
VERIFY(pDC->FillRgn( &rgnC, &brC ));
VERIFY(brA.CreateSolidBrush( RGB(255, 0, 0) ));  // rgnA Red
VERIFY(pDC->FrameRgn( &rgnA, &brA, 2, 2 ));
VERIFY(brB.CreateSolidBrush( RGB(0, 255, 0) ));  // rgnB Green
VERIFY(pDC->FrameRgn( &rgnB, &brB, 2, 2 ));