SetCursorPos-Funktion (winuser.h)

Artikel
03/13/2024

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)