Compartilhar via


CRgn::CreateRectRgn

Cria uma área retangular que é armazenada no objeto de CRgn .

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

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.

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 tiver terminado de usar uma região criada por CreateRectRgn, um aplicativo deve usar a função de membro de CGDIObject::DeleteObject para remover a região.

Exemplo

CRgn   rgn;

BOOL bSucceeded = rgn.CreateRectRgn( 50, 20, 150, 120 );
ASSERT( bSucceeded == TRUE );

Para um exemplo adicional, consulte CRgn::CombineRgn.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CRgn Class

Gráfico de hierarquia

CRgn::CreateRectRgnIndirect

CRgn::CreateRoundRectRgn

CreateRectRgn