Funzione PtInRect (winuser.h)

Articolo
08/27/2023

La funzione PtInRect determina se il punto specificato si trova all'interno del rettangolo specificato. Un punto si trova all'interno di un rettangolo se si trova sul lato sinistro o superiore o si trova all'interno di tutti e quattro i lati. Un punto sul lato destro o inferiore viene considerato all'esterno del rettangolo.

Sintassi

BOOL PtInRect(
  [in] const RECT *lprc,
  [in] POINT      pt
);

Parametri

[in] lprc

Puntatore a una struttura RECT contenente il rettangolo specificato.

[in] pt

Struttura POINT che contiene il punto specificato.

Valore restituito

Se il punto specificato si trova all'interno del rettangolo, il valore restituito è diverso da zero.

Se il punto specificato non si trova all'interno del rettangolo, il valore restituito è zero.

Commenti

Il rettangolo deve essere normalizzato prima che venga chiamato PtInRect . Ovvero, lprc.right deve essere maggiore di lprc.left e lprc.bottom deve essere maggiore di lprc.top. Se il rettangolo non è normalizzato, un punto non viene mai considerato all'interno del rettangolo.

Poiché le applicazioni possono usare rettangoli per scopi diversi, le funzioni rettangolo non usano un'unità di misura esplicita. Vengono invece specificate tutte le coordinate e le dimensioni del rettangolo in valori logici con segno. La modalità di mapping e la funzione in cui viene utilizzato il rettangolo determinano le unità di misura.

Esempio

Per un esempio, vedere Uso di rettangoli.

Requisiti


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