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 |