Freigeben über


ClientToScreen-Funktion (winuser.h)

Die ClientToScreen-Funktion konvertiert die Clientbereichkoordinaten eines angegebenen Punkts in Bildschirmkoordinaten.

Syntax

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

Parameter

[in] hWnd

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

[in, out] lpPoint

Ein Zeiger auf eine POINT-Struktur , die die zu konvertierenden Clientkoordinaten enthält. Die neuen Bildschirmkoordinaten werden in diese Struktur kopiert, wenn die Funktion erfolgreich ist.

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 ClientToScreen-Funktion ersetzt die Clientbereichkoordinaten in der POINT-Struktur durch die Bildschirmkoordinaten. Die Bildschirmkoordinaten sind relativ zur oberen linken Ecke des Bildschirms. Beachten Sie, dass ein Bildschirmkoordinatenpunkt, der sich über dem Clientbereich des Fensters befindet, eine negative y-Koordinate aufweist. Analog dazu weist eine Bildschirmkoordinate links neben einem Clientbereich eine negative x-Koordinate auf.

Alle Koordinaten sind Gerätekoordinaten.

Beispiele

Ein Beispiel finden Sie unter Zeichnen von Linien mit der Maus unter Verwenden der Mauseingabe.

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 (windows.h einschließen)
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

Übersicht über Koordinatenräume und Transformationen

MapWindowPoints

PUNKT

ScreenToClient