GetClipCursor-Funktion (winuser.h)

Artikel
03/13/2024

Ruft die Bildschirmkoordinaten des rechteckigen Bereichs ab, auf den der Cursor beschränkt ist.

Syntax

BOOL GetClipCursor(
  [out] LPRECT lpRect
);

Parameter

[out] lpRect

Typ: LPRECT

Ein Zeiger auf eine RECT-Struktur , die die Bildschirmkoordinaten des einschränkenden Rechtecks empfängt. Die Struktur empfängt die Dimensionen des Bildschirms, wenn der Cursor nicht auf ein Rechteck beschränkt ist.

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 mit der ClipCursor-Funktion einschränkt, muss sie den Cursor später mithilfe von ClipCursor freigeben, bevor sie das Steuerelement an eine andere Anwendung übergibt.

Der aufrufende Prozess muss WINSTA_READATTRIBUTES Zugriff auf die Fensterstation haben.

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 (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll