Freigeben über

CreateCursor-Funktion (winuser.h)

Erstellt einen monochromen Cursor mit der angegebenen Größe, Bitmustern und Hotspots.

Zum Erstellen eines farbigen Cursors zur Laufzeit 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 zur aktuellen Instanz der Anwendung, die den Cursor erstellt.

[in] xHotSpot

Typ: int

Die horizontale Position des Cursor-Hotspots.

[in] yHotSpot

Typ: int

Die vertikale Position des Cursor-Hotspots.

[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 Anmerkungen.

[in] pvXORPlane

Typ: const VOID*

Ein Array von Bytes, das die Bitwerte für die XOR-Maske des Cursors enthält, wie in einer monochromen Bitmap. Siehe Anmerkungen.

Rückgabewert

Typ: HCURSOR-

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für den Cursor.

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Um die Nominalgröße eines Cursors zu ermitteln, verwenden Sie die GetSystemMetrics--Funktion, wobei sie den SM_CXCURSOR- oder SM_CYCURSOR Wert angibt. Außerdem können Sie die DPI-fähige Version dieser API verwenden, siehe GetSystemMetricsForDpi. Weitere Informationen finden Sie unter Entwicklung von Desktopanwendungen mit hoher DPI-Auflösung unter Windows.

Weitere Informationen zu pvANDPlane und pvXORPlane Parametern finden Sie in der Beschreibung lpBits Parameter von CreateBitmap Funktion.

CreateCursor wendet die folgende Wahrheitstabelle auf die AND- und XOR-Bitmasken an:

UND Bitmaske XOR-Bitmaske Zeigen
0 0 Schwarz
0 1 Weiß
1 0 Bildschirm
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 nimmt nicht an der DPI-Virtualisierung teil. Die zurückgegebene Ausgabe entspricht den physischen Koordinaten und wird vom DPI-Wert des aufrufenden Threads nicht beeinflusst. Beachten Sie, dass der erstellte Cursor möglicherweise trotzdem skaliert wird, um dem DPI-Wert eines gegebenen Fensters zu entsprechen, in das er gezeichnet wird.

Beispiele

Ein Beispiel finden Sie unter Erstellen eines Cursors.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server- Windows 2000 Server [nur Desktop-Apps]
Zielplattform- Fenster
Header- winuser.h (enthalten Windows.h)
Library User32.lib
DLL- User32.dll

Siehe auch

CreateIcon

CreateIconIndirect

DestroyCursor

GetSystemMetrics-

SetCursor-

Cursor

  • Last updated on