SetCursor-Funktion (winuser.h)
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 |
Siehe auch
Konzept
Referenz