Fungsi ShowCaret (winuser.h)

Artikel
08/28/2023

Membuat tanda sisipan terlihat pada layar pada posisi tanda sisipan saat ini. Ketika tanda sisipan terlihat, ia mulai berkedip secara otomatis.

Sintaks

BOOL ShowCaret(
  [in, optional] HWND hWnd
);

Parameter

[in, optional] hWnd

Jenis: HWND

Handel ke jendela yang memiliki tanda sisipan. Jika parameter ini NULL, ShowCaret mencari tugas saat ini untuk jendela yang memiliki tanda sisipan.

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

ShowCaret menunjukkan tanda sisipan hanya jika jendela yang ditentukan memiliki tanda sisipan, tanda sisipan memiliki bentuk, dan tanda sisipan belum disembunyikan dua kali atau lebih berturut-turut. Jika satu atau beberapa kondisi ini tidak terpenuhi, ShowCaret tidak melakukan apa pun dan mengembalikan FALSE.

Menyembunyikan adalah kumulatif. Jika aplikasi Anda memanggil HideCaret lima kali berturut-turut, aplikasi juga harus memanggil ShowCaret lima kali sebelum caret muncul kembali.

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.

Contoh

Misalnya, lihat Membuat dan Menampilkan Caret.

Persyaratan


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 di Windows 8)