Função CreateRectRgn (wingdi.h)

Artigo
03/13/2024

A função CreateRectRgn cria uma região retangular.

Sintaxe

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

Parâmetros

[in] x1

Especifica a coordenada x do canto superior esquerdo da região em unidades lógicas.

[in] y1

Especifica a coordenada y do canto superior esquerdo da região em unidades lógicas.

[in] x2

Especifica a coordenada x do canto inferior direito da região em unidades lógicas.

[in] y2

Especifica a coordenada y do canto inferior direito da região em unidades lógicas.

Retornar valor

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í-lo.

As coordenadas de região são representadas como inteiros com sinal de 27 bits.

As regiões criadas pelos métodos Create<shape>Rgn (como CreateRectRgn e CreatePolygonRgn) incluem apenas o interior da forma; o contorno da forma é excluído da região. Isso significa que qualquer ponto em uma linha entre dois vértices sequenciais não está incluído na região. Se você chamasse PtInRegion para esse ponto, ele retornaria zero como resultado.

Exemplos

Para obter um exemplo, consulte Marcadores de desenho.

Requisitos

Requisito	Valor
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