ClipCursor-Funktion (winuser.h)

Artikel
03/13/2024

Beschränkt den Cursor auf einen rechteckigen Bereich auf dem Bildschirm. Wenn sich eine nachfolgende Cursorposition (festgelegt durch die SetCursorPos-Funktion oder die Maus) außerhalb des Rechtecks befindet, passt das System die Position automatisch an, um den Cursor innerhalb des rechteckigen Bereichs zu halten.

Syntax

BOOL ClipCursor(
  [in, optional] const RECT *lpRect
);

Parameter

[in, optional] lpRect

Typ: const RECT*

Ein Zeiger auf die Struktur, die die Bildschirmkoordinaten der oberen linken und unteren rechten Ecken des begrenzungsbezogenen Rechtecks enthält. Wenn dieser Parameter NULL ist, kann der Cursor an einer beliebigen Stelle auf dem Bildschirm bewegt werden.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Der Cursor ist eine freigegebene Ressource. Wenn eine Anwendung den Cursor einschränkt, muss sie den Cursor mithilfe von ClipCursor freigeben, bevor das Steuerelement an eine andere Anwendung abgegeben wird.

Der aufrufende Prozess muss über WINSTA_WRITEATTRIBUTES Zugriff auf die Fensterstation verfügen.

Beispiele

Ein Beispiel finden Sie unter Einschränken eines 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 (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll