SetCursor-Funktion (winuser.h)

Artikel
03/04/2024

Legt die Cursorform fest.

Syntax

HCURSOR SetCursor(
  [in, optional] HCURSOR hCursor
);

Parameter

[in, optional] hCursor

Typ: HCURSOR

Ein Handle für den Cursor.

Der Cursor muss entweder von der CreateCursor - oder der CreateIconIndirect-Funktion erstellt oder von der LoadCursor - oder loadImage-Funktion geladen worden sein.

Wenn dieser Parameter NULL ist, wird der Cursor aus dem Bildschirm entfernt.

Rückgabewert

Typ: HCURSOR

Der Rückgabewert ist das Handle für den vorherigen Cursor, sofern vorhanden.

Wenn kein vorheriger Cursor vorhanden war, ist der Rückgabewert NULL.

Hinweise

Der Cursor wird nur festgelegt, wenn sich der neue Cursor vom vorherigen Cursor unterscheidet. Andernfalls wird die Funktion sofort zurückgegeben.

Der Cursor ist eine freigegebene Ressource. Ein Fenster sollte die Cursorform nur festlegen, wenn sich der Cursor in seinem Clientbereich befindet oder wenn das Fenster Mauseingaben erfasst. In Systemen ohne Maus sollte das Fenster den vorherigen Cursor wiederherstellen, bevor der Cursor den Clientbereich verlässt oder bevor er das Steuerelement an ein anderes Fenster übergibt.

Wenn Ihre Anwendung den Cursor festlegen muss, während er sich in einem Fenster befindet, stellen Sie sicher, dass der Klassencursor für die Klasse des angegebenen Fensters auf NULL festgelegt ist. Wenn der Klassencursor nicht NULL ist, stellt das System den Klassencursor jedes Mal wieder her, wenn die Maus bewegt wird.

Der Cursor wird nicht auf dem Bildschirm angezeigt, wenn die Anzahl der internen Cursoranzeigen kleiner als 0 ist. Dies tritt auf, wenn die Anwendung die ShowCursor-Funktion verwendet, um den Cursor öfter auszublenden als den Cursor anzuzeigen.

Beispiele

Ein Beispiel finden Sie unter Anzeigen 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