Metode IDirect3DDevice9::SetCursorPosition (d3d9.h)

Artikel
02/26/2024

Mengatur opsi posisi kursor dan pembaruan.

Sintaks

void SetCursorPosition(
  [in] int   X,
  [in] int   Y,
  [in] DWORD Flags
);

Parameter

[in] X

Jenis: INT

Posisi X baru kursor dalam koordinat desktop virtual. Lihat Keterangan.

[in] Y

Jenis: INT

Posisi Y baru kursor dalam koordinat desktop virtual. Lihat Keterangan.

[in] Flags

Jenis: DWORD

Menentukan opsi pembaruan untuk kursor. Saat ini, hanya satu bendera yang ditentukan.

Nilai	Makna
D3DCURSOR_IMMEDIATE_UPDATE	Perbarui kursor pada kecepatan refresh. Jika bendera ini ditentukan, sistem menjamin bahwa kursor akan diperbarui minimal setengah laju refresh tampilan, tetapi tidak pernah lebih sering daripada laju refresh tampilan. Jika tidak, metode menunda pembaruan kursor hingga panggilan IDirect3DDevice9::P resent berikutnya. Tidak mengatur bendera ini biasanya menghasilkan performa yang lebih baik daripada jika bendera diatur. Namun, aplikasi harus mengatur bendera ini jika tingkat panggilan ke Present cukup rendah sehingga pengguna akan melihat keterlambatan gerakan kursor yang signifikan. Bendera ini tidak berpengaruh dalam aplikasi mode berjendela. Beberapa kartu video menerapkan kursor warna perangkat keras. Bendera ini tidak berpengaruh pada kartu ini.

Nilai

Makna

D3DCURSOR_IMMEDIATE_UPDATE

Perbarui kursor pada kecepatan refresh.

Jika bendera ini ditentukan, sistem menjamin bahwa kursor akan diperbarui minimal setengah laju refresh tampilan, tetapi tidak pernah lebih sering daripada laju refresh tampilan. Jika tidak, metode menunda pembaruan kursor hingga panggilan IDirect3DDevice9::P resent berikutnya. Tidak mengatur bendera ini biasanya menghasilkan performa yang lebih baik daripada jika bendera diatur. Namun, aplikasi harus mengatur bendera ini jika tingkat panggilan ke Present cukup rendah sehingga pengguna akan melihat keterlambatan gerakan kursor yang signifikan. Bendera ini tidak berpengaruh dalam aplikasi mode berjendela. Beberapa kartu video menerapkan kursor warna perangkat keras. Bendera ini tidak berpengaruh pada kartu ini.

Nilai kembali

Tidak ada

Keterangan

Saat berjalan dalam mode layar penuh, koordinat ruang layar adalah koordinat buffer belakang yang diskalakan dengan tepat ke mode tampilan saat ini. Saat berjalan dalam mode berjendela, koordinat ruang layar adalah koordinat desktop. Gambar kursor digambar pada posisi yang ditentukan dikurangi hotspot-offset yang ditentukan oleh metode SetCursorProperties .

Jika kursor telah disembunyikan oleh ShowCursor, kursor tidak digambar.