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
Funciones de espacio de coordenadas y transformación
Información general sobre espacios de coordenadas y transformaciones