SetSystemCursor-Funktion (winuser.h)

Artikel
03/04/2024

Ermöglicht einer Anwendung das Anpassen der Systemcursor. Er ersetzt den Inhalt des Systemcursors, der durch den id-Parameter angegeben wird, durch den Inhalt des Cursors, der durch den hcur-Parameter angegeben wird, und zerstört dann hcur.

Syntax

BOOL SetSystemCursor(
  [in] HCURSOR hcur,
  [in] DWORD   id
);

Parameter

[in] hcur

Typ: HCURSOR

Ein Handle für den Cursor. Die Funktion ersetzt den Inhalt des Systemcursors, der durch id angegeben wird, durch den Inhalt des Cursors, der von hcur behandelt wird.

Das System zerstört hcur durch Aufrufen der DestroyCursor-Funktion . Daher kann hcur kein Cursor sein, der mit der LoadCursor-Funktion geladen wird. Um einen aus einer Ressource geladenen Cursor anzugeben, kopieren Sie den Cursor mithilfe der CopyCursor-Funktion , und übergeben Sie die Kopie dann an SetSystemCursor.

[in] id

Art: DWORD

Der Systemcursor, der durch den Inhalt von hcur ersetzt werden soll. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
OCR_NORMAL `32512`	Normal auswählen
OCR_IBEAM `32513`	Textauswahl
OCR_WAIT `32514`	Busy
OCR_CROSS `32515`	Genauigkeitsauswahl
OCR_UP `32516`	Alternative Auswahl
OCR_SIZENWSE `32642`	Diagonale Größenänderung 1
OCR_SIZENESW `32643`	Diagonale Größenänderung 2
OCR_SIZEWE `32644`	Horizontale Größenänderung
OCR_SIZENS `32645`	Vertikale Größenänderung
OCR_SIZEALL `32646`	Move
OCR_NO `32648`	Nicht verfügbar
OCR_HAND `32649`	Link auswählen
OCR_APPSTARTING `32650`	Arbeiten im Hintergrund

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

Damit eine Anwendung eine der OCR_ Konstanten verwendet, muss die OEMRESOURCE-Konstante definiert werden, bevor die Windows.h-Headerdatei eingeschlossen wird.

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