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

Consulte también

ClientToScreen

Funciones de espacio de coordenadas y transformación

Información general sobre espacios de coordenadas y transformaciones

MapWindowPoints

PUNTO