Fungsi CreateCursor (winuser.h)

Artikel
01/27/2024

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