Función ScreenToClient (winuser.h)

La función ScreenToClient convierte las coordenadas de pantalla de un punto especificado en la pantalla en coordenadas de área de cliente.

Sintaxis

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

Parámetros

[in] hWnd

Identificador de la ventana cuyo área de cliente se usará para la conversión.

lpPoint

Puntero a una estructura POINT que especifica las coordenadas de pantalla que se van a convertir.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

La función usa la ventana identificada por el parámetro hWnd y las coordenadas de pantalla proporcionadas en la estructura POINT para calcular las coordenadas del cliente. A continuación, reemplaza las coordenadas de pantalla por las coordenadas del cliente. Las nuevas coordenadas son relativas a la esquina superior izquierda del área cliente de la ventana especificada.

La función ScreenToClient supone que el punto especificado está en coordenadas de pantalla.

Todas las coordenadas están en unidades de dispositivo.

No use ScreenToClient cuando se produzca una situación de creación de reflejo, es decir, al cambiar de diseño de izquierda a derecha a izquierda. En su lugar, use MapWindowPoints. Para obtener más información, vea "Diseño de ventana y creación de reflejo" en Características de ventana.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-window-l1-1-2 (introducido en Windows 10, versión 10.0.10240)

Consulte también

ClientToScreen

Funciones de espacio de coordenadas y transformación

Información general sobre espacios de coordenadas y transformaciones

MapWindowPoints

PUNTO