Função CreateRectRgn (wingdi.h)
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 |