CRgn::CreateRoundRectRgn

Artigo
02/25/2013

Cria uma área retangular com os cantos arredondados que é armazenada no objeto de CRgn .

BOOL CreateRoundRectRgn(
   int x1,
   int y1,
   int x2,
   int y2,
   int x3,
   int y3 
);

Parâmetros

x1
Especifica a coordenada x lógica do canto superior esquerdo da região.
y1
Especifica a coordenada y lógica do canto superior esquerdo da região.
x2
Especifica a coordenada x lógica do canto inferior direito da região.
y2
Especifica a coordenada y lógica do canto inferior direito da região.
x3
Especifica a largura da elipse usada para criar os cantos arredondados.
y3
Especifica a altura da elipse usada para criar os cantos arredondados.

Valor de retorno

Diferente de zero se a operação foi bem-sucedida; se não 0.

Comentários

O tamanho de uma região é limitado a 32.767 por 32.767 unidades lógicas ou a 64K de memória, qualquer é menor.

Quando um aplicativo tiver terminado de usar uma região criada com a função de CreateRoundRectRgn , deve selecionar a região fora do contexto de dispositivo e usar a função de membro de CGDIObject::DeleteObject para removê-la.

Exemplo

CRgn   rgnA, rgnB, rgnC;

VERIFY(rgnA.CreateRoundRectRgn( 50, 50, 150, 150, 30, 30 ));
VERIFY(rgnB.CreateRoundRectRgn( 200, 75, 250, 125, 50, 50 ));
VERIFY(rgnC.CreateRectRgn( 0, 0, 50, 50 ));

int nCombineResult = rgnC.CombineRgn( &rgnA, &rgnB, RGN_OR );
ASSERT( nCombineResult != ERROR && nCombineResult != NULLREGION );

CBrush brA, brB, brC;
VERIFY(brA.CreateSolidBrush( RGB(255, 0, 0) ));  
VERIFY(pDC->FillRgn( &rgnA, &brA));      // rgnA Red Filled

VERIFY(brB.CreateSolidBrush( RGB(0, 255, 0) ));  
VERIFY(pDC->FillRgn( &rgnB, &brB));      // rgnB Green Filled
VERIFY(brC.CreateSolidBrush( RGB(0, 0, 255) ));  // rgnC Blue
VERIFY(pDC->FrameRgn( &rgnC, &brC, 2, 2 ));