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

Vedi anche

ClientToScreen

Funzioni di coordinata e trasformazione

Panoramica degli spazi e delle trasformazioni delle coordinate

MapWindowPoints

PUNTO