Freigeben über


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.

Syntax

BOOL SetCursorPos(
  [in] int X,
  [in] int Y
);

Parameter

[in] X

Typ: int

Die neue x-Koordinate des Cursors in Bildschirmkoordinaten.

[in] Y

Typ: int

Die neue y-Koordinate des Cursors in Bildschirmkoordinaten.

Rückgabewert

Typ: BOOL

Gibt nonzero zurück, wenn der Vorgang erfolgreich war oder andernfalls null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

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.

Beispiele

Ein Beispiel finden Sie unter Verwenden der Tastatur zum Bewegen des Cursors.

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

ClipCursor

Konzept

Cursor

GetCursorPos

Referenz

SetCaretPos

SetCursor

ShowCursor