Funzione CreateRectRgn (wingdi.h)

Articolo
08/27/2023

La funzione CreateRectRgn crea un'area rettangolare.

Sintassi

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

Parametri

[in] x1

Specifica la coordinata x dell'angolo superiore sinistro dell'area nelle unità logiche.

[in] y1

Specifica la coordinata y dell'angolo superiore sinistro dell'area nelle unità logiche.

[in] x2

Specifica la coordinata x dell'angolo inferiore destro dell'area nelle unità logiche.

[in] y2

Specifica la coordinata y dell'angolo inferiore destro dell'area nelle unità logiche.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è l'handle nell'area.

Se la funzione ha esito negativo, il valore restituito è NULL.

Commenti

Quando non è più necessario l'oggetto HRGN , chiamare la funzione DeleteObject per eliminarla.

Le coordinate dell'area sono rappresentate come interi con segno a 27 bit.

Le aree create dai metodi Create<shape>Rgn (ad esempio CreateRectRgn e CreatePolygonRgn) includono solo l'interno della forma. La struttura della forma viene esclusa dall'area. Ciò significa che qualsiasi punto su una linea tra due vertici sequenziali non è incluso nell'area. Se si dovesse chiamare PtInRegion per un punto di questo tipo, verrà restituito zero come risultato.

Esempio

Per un esempio, vedere Marcatori di disegno.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll