CreateCursor-Funktion (winuser.h)

Artikel
01/27/2024

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