Funzione ScreenToClient (winuser.h)

La funzione ScreenToClient converte le coordinate dello schermo di un punto specificato sullo schermo nelle coordinate dell'area client.

Sintassi

BOOL ScreenToClient(
  [in] HWND    hWnd,
       LPPOINT lpPoint
);

Parametri

[in] hWnd

Handle nella finestra di cui verrà usata l'area client per la conversione.

lpPoint

Puntatore a una struttura POINT che specifica le coordinate dello schermo da convertire.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

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

Commenti

La funzione usa la finestra identificata dal parametro hWnd e le coordinate dello schermo indicate nella struttura POINT per calcolare le coordinate client. Sostituisce quindi le coordinate dello schermo con le coordinate client. Le nuove coordinate sono relative all'angolo superiore sinistro dell'area client della finestra specificata.

La funzione ScreenToClient presuppone che il punto specificato sia in coordinate dello schermo.

Tutte le coordinate si trovano in unità dispositivo.

Non usare ScreenToClient quando si verifica una situazione di mirroring, ovvero quando si passa dal layout da sinistra a destra al layout da destra a sinistra a sinistra. Usare invece MapWindowPoints. Per altre informazioni, vedere "Layout finestra e mirroring" in Funzionalità della finestra.

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	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-window-l1-1-2 (introdotta in Windows 10, versione 10.0.10240)

Vedi anche

ClientToScreen

Funzioni di coordinata e trasformazione

Panoramica degli spazi e delle trasformazioni delle coordinate

MapWindowPoints

PUNTO