Funzione ClientToScreen (winuser.h)

Articolo
03/04/2024

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

Sintassi

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

Parametri

[in] hWnd

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

[in, out] lpPoint

Puntatore a una struttura POINT che contiene le coordinate client da convertire. Le nuove coordinate dello schermo vengono copiate in questa struttura se la funzione ha esito positivo.

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 ClientToScreen sostituisce le coordinate dell'area client nella struttura POINT con le coordinate dello schermo. Le coordinate dello schermo sono relative all'angolo superiore sinistro dello schermo. Nota, un punto di coordinata dello schermo sopra l'area client della finestra ha una coordinata y negativa. Analogamente, una coordinata dello schermo a sinistra di un'area client ha una coordinata x negativa.

Tutte le coordinate sono coordinate del dispositivo.

Esempio

Per un esempio, vedere "Disegno linee con il mouse" in Uso dell'input del mouse.

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)