CreateCursor-Funktion (winuser.h)
Erstellt einen monochromen Cursor mit der angegebenen Größe, Bitmustern und Hot Spot.
Um einen farbigen Cursor zur Laufzeit zu erstellen, können Sie die CreateIconIndirect-Funktion verwenden, die einen Cursor basierend auf dem Inhalt einer ICONINFO-Struktur erstellt.
Syntax
HCURSOR CreateCursor(
[in, optional] HINSTANCE hInst,
[in] int xHotSpot,
[in] int yHotSpot,
[in] int nWidth,
[in] int nHeight,
[in] const VOID *pvANDPlane,
[in] const VOID *pvXORPlane
);
Parameter
[in, optional] hInst
Typ: HINSTANCE
Ein Handle für den aktuellen instance der Anwendung, die den Cursor erstellt.
[in] xHotSpot
Typ: int
Die horizontale Position des HotSpots des Cursors.
[in] yHotSpot
Typ: int
Die vertikale Position des Hotspots des Cursors.
[in] nWidth
Typ: int
Die Breite des Cursors in Pixel.
[in] nHeight
Typ: int
Die Höhe des Cursors in Pixel.
[in] pvANDPlane
Typ: const VOID*
Ein Array von Bytes, das die Bitwerte für die AND-Maske des Cursors enthält, wie in einer monochromen Bitmap. Siehe Bemerkungen.
[in] pvXORPlane
Typ: const VOID*
Ein Bytearray, das die Bitwerte für die XOR-Maske des Cursors enthält, wie in einer monochromen Bitmap. Siehe Bemerkungen.
Rückgabewert
Typ: HCURSOR
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für den Cursor.
Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Um die Nominalgröße eines Cursors zu bestimmen, verwenden Sie die GetSystemMetrics-Funktion , indem Sie den SM_CXCURSOR - oder SM_CYCURSOR-Wert angeben. Außerdem können Sie die DPI-fähige Version dieser API verwenden, siehe (GetSystemMetricsForDpi)(/windows/win32/api/winuser/nf-winuser-getsystemmetricsfordpi). Weitere Informationen finden Sie unter Hohe DPI-Desktopanwendungsentwicklung unter Windows.
Weitere Informationen zu pvANDPlane - und pvXORPlane-Parametern finden Sie in der Beschreibung des lpBits-Parameters der CreateBitmap-Funktion .
CreateCursor wendet die folgende Wahrheitstabelle auf die Bitmasken AND und XOR an:
| UND Bitmaske | XOR-Bitmaske | Anzeige |
|---|---|---|
| 0 | 0 | Schwarz |
| 0 | 1 | White |
| 1 | 0 | Screen |
| 1 | 1 | Umgekehrter Bildschirm |
Vor dem Schließen muss eine Anwendung die DestroyCursor-Funktion aufrufen, um alle Systemressourcen freizugeben, die dem Cursor zugeordnet sind.
DPI-Virtualisierung
Diese API ist nicht an der DPI-Virtualisierung beteiligt. Die zurückgegebene Ausgabe entspricht den physischen Koordinaten und wird nicht vom DPI des aufrufenden Threads beeinflusst. Beachten Sie, dass der erstellte Cursor trotzdem so skaliert werden kann, dass er dem DPI-Wert eines beliebigen Fensters entspricht, in das er gezeichnet wird.Beispiele
Ein Beispiel finden Sie unter Erstellen eines Cursors.
Anforderungen
| 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 |