Fungsi SetCaretPos (winuser.h)

Artikel
08/28/2023

Memindahkan tanda sisipan ke koordinat yang ditentukan. Jika jendela yang memiliki tanda sisipan dibuat dengan gaya kelas CS_OWNDC , maka koordinat yang ditentukan tunduk pada mode pemetaan konteks perangkat yang terkait dengan jendela tersebut.

Sintaks

BOOL SetCaretPos(
  [in] int X,
  [in] int Y
);

Parameter

[in] X

Jenis: int

Koordinat x baru dari caret.

[in] Y

Jenis: int

Koordinat y baru dari caret.

Nilai kembali

Jenis: BOOL

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

SetCaretPos memindahkan tanda sisipan apakah tanda sisipan disembunyikan.

Sistem menyediakan satu caret per antrean. Jendela harus membuat tanda sisipan hanya ketika memiliki fokus keyboard atau aktif. Jendela harus menghancurkan tanda sisipan sebelum kehilangan fokus keyboard atau menjadi tidak aktif. Jendela dapat mengatur posisi tanda sisipan hanya jika memiliki tanda sisipan.

Virtualisasi DPI

API ini tidak berpartisipasi dalam virtualisasi DPI. Posisi yang disediakan ditafsirkan sebagai koordinat logis dalam hal jendela yang terkait dengan tanda sisipan. Utas panggilan tidak dipertimbangkan.

Contoh

Misalnya, lihat Membuat dan Menampilkan Caret.

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 (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-caret-l1-1-0 (diperkenalkan dalam Windows 8)