ScreenToClient-Funktion (winuser.h)

Die ScreenToClient-Funktion konvertiert die Bildschirmkoordinaten eines angegebenen Punkts auf dem Bildschirm in Clientbereichskoordinaten.

Syntax

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

Parameter

[in] hWnd

Ein Handle für das Fenster, dessen Clientbereich für die Konvertierung verwendet wird.

lpPoint

Ein Zeiger auf eine POINT-Struktur , die die zu konvertierenden Bildschirmkoordinaten angibt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Die Funktion verwendet das durch den hWnd-Parameter identifizierte Fenster und die in der POINT-Struktur angegebenen Bildschirmkoordinaten, um Clientkoordinaten zu berechnen. Anschließend werden die Bildschirmkoordinaten durch die Clientkoordinaten ersetzt. Die neuen Koordinaten sind relativ zur linken oberen Ecke des Clientbereichs des angegebenen Fensters.

Die ScreenToClient-Funktion setzt voraus, dass sich der angegebene Punkt in Bildschirmkoordinaten befindet.

Alle Koordinaten befinden sich in Geräteeinheiten.

Verwenden Sie ScreenToClient nicht in einer Spiegelungssituation, d. h. beim Wechsel vom Layout von links nach rechts in das Layout von rechts nach links. Verwenden Sie stattdessen MapWindowPoints. Weitere Informationen finden Sie unter Fensterlayout und Spiegelung in Fensterfeatures.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-window-l1-1-2 (eingeführt in Windows 10, Version 10.0.10240)

Weitere Informationen

ClientToScreen

Koordinatenraum und Transformationsfunktionen

Übersicht über Koordinatenräume und Transformationen

MapWindowPoints

PUNKT