Bagikan melalui


Fungsi SetCursor (winuser.h)

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

Lihat juga

Konseptual

Kursor

Membuat Kursor

CreateCursor

CreateIconIndirect

GetCursor

GetSystemMetrics

LoadCursor

LoadImage

Referensi

SetCursorPos

ShowCursor