Compartilhar via


Função CreateEllipticRgn (wingdi.h)

A função CreateEllipticRgn cria uma região elíptica.

Sintaxe

HRGN CreateEllipticRgn(
  [in] int x1,
  [in] int y1,
  [in] int x2,
  [in] int y2
);

Parâmetros

[in] x1

Especifica a coordenada x em unidades lógicas, do canto superior esquerdo do retângulo delimitador da elipse.

[in] y1

Especifica a coordenada y em unidades lógicas, do canto superior esquerdo do retângulo delimitador da elipse.

[in] x2

Especifica a coordenada x em unidades lógicas, do canto inferior direito do retângulo delimitador da elipse.

[in] y2

Especifica a coordenada y em unidades lógicas, do canto inferior direito do retângulo delimitador da elipse.

Valor retornado

Se a função for bem-sucedida, o valor retornado será o identificador para a região.

Se a função falhar, o valor retornado será NULL.

Comentários

Quando você não precisar mais do objeto HRGN, chame a função DeleteObject para excluí-la.

Um retângulo delimitador define o tamanho, a forma e a orientação da região: os lados longos do retângulo definem o comprimento do eixo principal da elipse; os lados curtos definem o comprimento do eixo secundário da elipse; e o centro do retângulo define a interseção dos eixos principal e secundário.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wingdi.h (inclua Windows.h)
Biblioteca Gdi32.lib
DLL Gdi32.dll

Confira também

CreateEllipticRegnIndirect

DeleteObject

Funções de região

Visão geral das regiões

Selectobject