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
Koordinatenraum und Transformationsfunktionen