Freigeben über


SetSystemCursor-Funktion (winuser.h)

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

Siehe auch

Konzept

Cursor

DestroyCursor

LoadCursor

LoadCursorFromFile

Referenz

SetCursor