Condividi tramite


Funzione CreateRectRgn (wingdi.h)

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

Vedi anche

CreatePolyPolygonRgn

CreatePolygonRgn

CreateRectRgnIndirect

CreateRoundRectRgn

DeleteObject

ExtCreateRegion

GetRegionData

Funzioni di area

Panoramica delle aree

SelectObject