Fungsi SetCursor (winuser.h)

Artikel
08/28/2023

Mengatur bentuk kursor.

Sintaks

HCURSOR SetCursor(
  [in, optional] HCURSOR hCursor
);

Parameter

[in, optional] hCursor

Jenis: HCURSOR

Handel ke kursor.

Kursor harus dibuat oleh CreateCursor atau fungsi CreateIconIndirect , atau dimuat oleh fungsi LoadCursor atau LoadImage .

Jika parameter ini NULL, kursor akan dihapus dari layar.

Nilai kembali

Jenis: HCURSOR

Nilai yang dikembalikan adalah handel ke kursor sebelumnya, jika ada.

Jika tidak ada kursor sebelumnya, nilai yang dikembalikan adalah NULL.

Keterangan

Kursor diatur hanya jika kursor baru berbeda dari kursor sebelumnya; jika tidak, fungsi akan segera kembali.

Kursor adalah sumber daya bersama. Jendela harus mengatur bentuk kursor hanya ketika kursor berada di area kliennya atau ketika jendela menangkap input mouse. Dalam sistem tanpa mouse, jendela harus memulihkan kursor sebelumnya sebelum kursor meninggalkan area klien atau sebelum melepaskan kontrol ke jendela lain.

Jika aplikasi Anda harus mengatur kursor saat berada di jendela, pastikan kursor kelas untuk kelas jendela yang ditentukan diatur ke NULL. Jika kursor kelas bukan NULL, sistem memulihkan kursor kelas setiap kali mouse dipindahkan.

Kursor tidak ditampilkan di layar jika jumlah tampilan kursor internal kurang dari nol. Ini terjadi jika aplikasi menggunakan fungsi ShowCursor untuk menyembunyikan kursor lebih banyak kali daripada menampilkan kursor.

Contoh

Misalnya, lihat Menampilkan Kursor.

Persyaratan

Persyaratan	Nilai
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 (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll