CRgn::CreateEllipticRgn

Статья
02/20/2013

Создает эллиптическую область.

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

Параметры

x1
Указывает логическую пару координат (x верхн- левого верхнего угла ограничивающего прямоугольника эллипса.
y1
Указывает логическое верхн- координату по оси y верхнего левого угла ограничивающего прямоугольника по оси y эллипса.
x2
Указывает логическую пару координат (x низк- правого верхнего угла ограничивающего прямоугольника по оси y эллипса.
y2
Указывает логическое низк- координату по оси y правого верхнего угла ограничивающего прямоугольника по оси y эллипса.

Возвращаемое значение

Ненулевой, если операция завершилась успешно; в противном случае – значение 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 ));