Metode IPenInputPanel::EnableTsf (peninputpanel.h)

  • Artikel

[ PenInputPanel telah digantikan oleh Panel Input Teks (TIP).]

Dihentikan. Mendapatkan atau menetapkan nilai Boolean yang menunjukkan apakah objek PenInputPanel mencoba mengirim teks ke kontrol terlampir melalui Text Services Framework (TSF) dan memungkinkan penggunaan antarmuka pengguna koreksi .

Sintaks

HRESULT EnableTsf(
  VARIANT_BOOL Enable
);

Parameter

Enable

TRUE jika objek PenInputPanel harus mencoba mengirim teks ke kontrol terlampir menggunakan TSF dan bahwa antarmuka pengguna koreksi harus diaktifkan; jika tidak FALSE. Nilai defaultnya adalah TRUE.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode Deskripsi
S_OK
 Berhasil.
E_UNEXPECTED
 Parameter atau jenis properti yang tidak terduga.
E_NOINTERFACE
 Antarmuka TSF tidak terekspos pada kontrol yang terpasang.
E_FAIL
 Terjadi kesalahan yang tidak ditentukan.

Keterangan

Memanggil metode ini dengan Aktifkan diatur ke TRUE menyebabkan objek PenInputPanel mencoba memulai TSF pada kontrol terlampir.

EnableTsf harus digunakan untuk mengaktifkan PenInputPanel untuk menggunakan konteks penyisipan TSF daripada fungsi SendInput untuk mengirim hasil pengenalan tulisan tangan ke dalam kontrol. Hasilnya adalah teks dapat disisipkan meskipun bidang tidak lagi memiliki fokus.

Saat Anda memanggil EnableTsf dengan nilai TRUE, objek PenInputPanel mengirim pesan EM_SETEDITSTYLE ke kontrol terlampir. Jika kontrol tidak mendukung pesan ini, hasilnya mungkin tidak dapat diprediksi. Kontrol InkEdit memang mendukung TSF.

Dukungan untuk Aplikasi Warisan

Dukungan telah ditambahkan ke TSF dan Microsoft Windows untuk menyediakan antarmuka pengguna yang konsisten untuk semua aplikasi di seluruh desktop. Dukungan baru ini memungkinkan aplikasi warisan atau kontrol yang tidak menyadari TSF untuk memanfaatkan beberapa layanan teks canggih secara gratis. Misalnya, dikte ucapan dan tulisan tangan sekarang dapat digunakan untuk memasukkan teks ke dalam dokumen dalam aplikasi apa pun.

Fitur baru ini tersedia dan diaktifkan secara default pada Windows XP Tablet PC Edition. Untuk mengaktifkan atau menonaktifkannya:

  1. Di Panel Kontrol, klik Opsi Regional dan Bahasa.
  2. Pada tab Bahasa , klik Detail.
  3. Pada tab Tingkat Lanjut dari kotak dialog Layanan Teks dan Bahasa Input , pilih atau kosongkan Perluas dukungan layanan teks tingkat lanjut ke semua program.
Jika berhasil, teks dikirim ke kontrol terlampir melalui TSF. Selain itu, jika kontrol mendukung TSF (dan tidak hanya menerima teks dari TSF hanya karena Advanced Text Services telah diaktifkan untuk semua program di Panel Kontrol seperti yang disebutkan di atas), maka antarmuka pengguna koreksi muncul dalam kontrol dan memungkinkan akses ke alternatif tulisan tangan. Memanggil metode ini dengan Aktifkan diatur ke FALSE menyebabkan objek PenInputPanel mencoba mematikan TSF pada kontrol terlampir.

Persyaratan

   
Klien minimum yang didukung Windows XP Tablet PC Edition [hanya aplikasi desktop]
Server minimum yang didukung Tidak ada yang didukung
Target Platform Windows
Header peninputpanel.h
Pustaka InkObj.dll

Lihat juga

IPenInputPanel

PenInputPanel