Función ClientToScreen (winuser.h)

Artículo
03/13/2024

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

Sintaxis

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

Parámetros

[in] hWnd

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

[in, out] lpPoint

Puntero a una estructura POINT que contiene las coordenadas de cliente que se van a convertir. Las nuevas coordenadas de pantalla se copian en esta estructura si la función se realiza correctamente.

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 ClientToScreen reemplaza las coordenadas del área de cliente en la estructura POINT por las coordenadas de pantalla. Las coordenadas de la pantalla son relativas a la esquina superior izquierda de la pantalla. Tenga en cuenta que un punto de coordenada de pantalla que está encima del área de cliente de la ventana tiene una coordenada y negativa. De forma similar, una coordenada de pantalla a la izquierda de un área de cliente tiene una coordenada x negativa.

Todas las coordenadas son coordenadas del dispositivo.

Ejemplos

Para obtener un ejemplo, vea "Dibujar líneas con el mouse" en Usar entrada del mouse.

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)