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 |