Fungsi CreateCursor (winuser.h)
Membuat kursor monokrom yang memiliki ukuran, pola bit, dan hot spot yang ditentukan.
Untuk membuat kursor berwarna pada durasi, Anda dapat menggunakan fungsi CreateIconIndirect , yang membuat kursor berdasarkan konten struktur ICONINFO .
Sintaks
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
Jenis: HINSTANCE
Handel ke instans aplikasi saat ini yang membuat kursor.
[in] xHotSpot
Jenis: int
Posisi horizontal titik panas kursor.
[in] yHotSpot
Jenis: int
Posisi vertikal titik panas kursor.
[in] nWidth
Jenis: int
Lebar kursor, dalam piksel.
[in] nHeight
Jenis: int
Tinggi kursor, dalam piksel.
[in] pvANDPlane
Jenis: const VOID*
Array byte yang berisi nilai bit untuk topeng AND kursor, seperti dalam bitmap monokrom. Lihat komentar.
[in] pvXORPlane
Jenis: const VOID*
Array byte yang berisi nilai bit untuk mask XOR kursor, seperti dalam bitmap monokrom. Lihat komentar.
Mengembalikan nilai
Jenis: HCURSOR
Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke kursor.
Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Untuk menentukan ukuran nominal kursor, gunakan fungsi GetSystemMetrics , menentukan nilai SM_CXCURSOR atau SM_CYCURSOR . Selain itu, Anda dapat menggunakan versi API yang sadar DPI, lihat (GetSystemMetricsForDpi)(/windows/win32/api/winuser/nf-winuser-getsystemmetricsfordpi). Untuk informasi selengkapnya lihat Pengembangan Aplikasi Desktop DPI Tinggi di Windows.
Untuk informasi selengkapnya tentang parameter pvANDPlane dan pvXORPlane lihat deskripsi parameter lpBits dari fungsi CreateBitmap .
CreateCursor menerapkan tabel kebenaran berikut ke bitmasks AND dan XOR:
| BITMASK AND | Bitmask XOR | Tampilan |
|---|---|---|
| 0 | 0 | Hitam |
| 0 | 1 | Putih |
| 1 | 0 | Layar |
| 1 | 1 | Layar terbalik |
Sebelum menutup, aplikasi harus memanggil fungsi DestroyCursor untuk membebaskan sumber daya sistem apa pun yang terkait dengan kursor.
Virtualisasi DPI
API ini tidak berpartisipasi dalam virtualisasi DPI. Output yang dikembalikan adalah dalam hal koordinat fisik, dan tidak terpengaruh oleh DPI dari utas panggilan. Perhatikan bahwa kursor yang dibuat masih dapat diskalakan agar sesuai dengan DPI dari jendela tertentu yang digambarnya.Contoh
Misalnya, lihat Membuat Kursor.
Persyaratan
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | winuser.h (sertakan Windows.h) |
| Pustaka | User32.lib |
| DLL | User32.dll |