Bagikan melalui

Fungsi CreateCursor (winuser.h)

  • Artikel

Membuat kursor monokrom yang memiliki ukuran, pola bit, dan hot spot yang ditentukan.

Untuk membuat kursor berwarna pada waktu proses, Anda dapat menggunakan fungsi CreateIconIndirect, yang membuat kursor berdasarkan konten struktur ICONINFO.

Sintaksis

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 hot spot 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 pengembalian adalah handel ke kursor.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Untuk menentukan ukuran nominal kursor, gunakan fungsi GetSystemMetrics, menentukan nilai SM_CXCURSOR atau SM_CYCURSOR. Selain itu, Anda dapat menggunakan api ini versi sadar DPI, lihat GetSystemMetricsForDpi. Untuk informasi selengkapnya, lihat Pengembangan Aplikasi Desktop DPI Tinggi di Windows.

Untuk informasi selengkapnya tentang parameter pvANDPlane dan pvXORPlane lihat deskripsi parameter lpBits fungsi CreateBitmap.

CreateCursor menerapkan tabel kebenaran berikut ke bitmask AND dan XOR:

BITMASK AND Bitmask XOR Menampilkan
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 utas panggilan. Perhatikan bahwa kursor yang dibuat mungkin masih diskalakan agar sesuai dengan DPI dari jendela tertentu yang digambar.

Contoh

Misalnya, lihat Membuat Kursor.

Persyaratan

Syarat Nilai
klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Platform Target Windows
Header winuser.h (termasuk Windows.h)
Pustaka User32.lib
DLL User32.dll

Lihat juga

CreateIcon

CreateIconIndirect

DestroyCursor

GetSystemMetrics

SetCursor

Kursor