SetCursorPos-Funktion (winuser.h)
Verschiebt den Cursor auf die angegebenen Bildschirmkoordinaten. Wenn sich die neuen Koordinaten nicht innerhalb des Bildschirmrechtecks befinden, das durch den letzten ClipCursor-Funktionsaufruf festgelegt wurde, passt das System die Koordinaten automatisch an, sodass der Cursor innerhalb des Rechtecks bleibt.
BOOL SetCursorPos(
[in] int X,
[in] int Y
);
[in] X
Typ: int
Die neue x-Koordinate des Cursors in Bildschirmkoordinaten.
[in] Y
Typ: int
Die neue y-Koordinate des Cursors in Bildschirmkoordinaten.
Typ: BOOL
Gibt nonzero zurück, wenn der Vorgang erfolgreich war oder andernfalls null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Der Cursor ist eine freigegebene Ressource. Ein Fenster sollte den Cursor nur verschieben, wenn sich der Cursor im Clientbereich des Fensters befindet.
Der aufrufende Prozess muss WINSTA_WRITEATTRIBUTES Zugriff auf die Fensterstation haben.
Der Eingabedesktop muss der aktuelle Desktop sein, wenn Sie SetCursorPos aufrufen. Rufen Sie OpenInputDesktop auf, um zu ermitteln, ob der aktuelle Desktop der Eingabedesktop ist. Wenn nicht, rufen Sie SetThreadDesktop mit dem von OpenInputDesktop zurückgegebenen HDESK auf, um zu diesem Desktop zu wechseln.
Ein Beispiel finden Sie unter Verwenden der Tastatur zum Bewegen des Cursors.
| 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) |
Konzept
Referenz