Memprogram Panel Input Menggunakan Kelas PenInputPanel

  • Artikel

[PenInputPanel telah digantikan oleh Microsoft.Ink.TextInput. Silakan merujuk ke Pemrograman Panel Masukan Teks.]

Deskripsi penggunaan objek PenInputPanel untuk memprogram Panel Input PC Tablet tingkat sistem.

Panel Input vs. Objek PenInputPanel

Dalam Microsoft Windows XP Tablet PC Edition versi 1.0, Panel Input PC Tablet tingkat sistem menyediakan mekanisme universal untuk menyelesaikan input teks di seluruh platform Windows, tetapi tidak menyediakan akses terprogram. Dalam Windows XP Tablet PC Edition Software Development Kit (SDK) versi 1.5 dan yang lebih baru, objek PenInputPanel memungkinkan Anda untuk mengintegrasikan alat input teks langsung ke dalam aplikasi Anda, dan memberikan tingkat kontrol yang sebelumnya tidak tersedia. Dimulai dengan Windows XP Tablet PC Edition 2005, Panel Input tingkat sistem telah ditingkatkan untuk menyertakan fungsi input di tempat yang disediakan oleh objek PenInputPanel dan banyak lagi.

Grafik berikut menunjukkan Panel Input yang ditampilkan di atas sampel Sampel Formulir Klaim Otomatis .

panel input ditampilkan di atas formulir yang digunakan untuk klaim mobil

Panel Input menggantikan PenInputPanel dengan menyediakan fungsionalitas input di tempat yang sama ke aplikasi apa pun yang berjalan pada Windows XP Tablet PC Edition 2005 atau yang lebih baru tanpa perlu kode tambahan. Artikel tentang menggunakan objek PenInputPanel ini disediakan untuk kompatibilitas mundur. Aplikasi yang sudah menggunakan objek PenInputPanel akan berfungsi sama kecuali bahwa Panel Input akan ditampilkan alih-alih PenInputPanel ketika aplikasi dijalankan pada Windows XP Tablet PC Edition 2005 atau yang lebih baru.

Jika Anda mengembangkan aplikasi baru untuk PC Tablet dan ingin memiliki solusi input pengguna di tempat, Panel Input menyediakan ini secara otomatis pada Windows XP Tablet PC Edition 2005 atau yang lebih baru. Tidak perlu membuat instans objek PenInputPanel .

Menonaktifkan Panel Input

Mungkin ada kasus di mana Anda ingin menonaktifkan Panel Input. Ada dua cara Anda dapat mencapainya. Anda dapat menyelesaikan ini secara terprogram atau dengan mengatur entri registri yang menonaktifkan Panel Input untuk seluruh aplikasi Anda.

Menonaktifkan Panel Input Secara Terprogram

Untuk menonaktifkan Panel Input secara terprogram, buat instans PenInputPanel dan atur properti AutoShow-nya ke False.

using Microsoft.Ink;

// ...

private PenInputPanel theInputPanel;

// ...

private void Form1_Load(object sender, System.EventArgs e)
{
// Attach the Input Panel to a specific TextBox control.
theInputPanel = new PenInputPanel(textBox1);

// Disable the Input Panel for the TextBox.
theInputPanel.AutoShow = false;
}

Untuk menonaktifkan Panel Input untuk beberapa kontrol dalam satu aplikasi, buat instans objek PenInputPanel untuk setiap kontrol dan atur properti AutoShowke False untuk masing-masing atau buat instans satu PenInputPanel dan pindahkan dari kontrol ke kontrol saat fokus input berubah. Untuk informasi selengkapnya tentang kedua teknik ini, lihat topik Sampel PenInputPanel .

Menonaktifkan Panel Input Melalui Registri

Anda dapat mengatur entri registri untuk menonaktifkan Panel Input untuk seluruh aplikasi Anda. Namun, ini juga akan menonaktifkannya untuk kotak dialog umum seperti kotak dialog Buka File , kotak dialog Cetak , dan kotak dialog Simpan File . Hal ini dapat membuat pengalaman pengguna dalam aplikasi Anda tidak konsisten dengan aplikasi PC Tablet lainnya.

DisableInPlace Mengatur kunci registri ke nol mencegah antarmuka pengguna (UI) Panel Input muncul dalam aplikasi. Anda harus menempatkan DisableInPlace kunci registri di HKEY_LOCAL_MACHINE\Software\Microsoft\TabletTip\. Kemudian, tambahkan nilai registri baru dengan menggunakan jalur lengkap aplikasi tempat Anda ingin menonaktifkan Panel Input. Contoh entri registri berikut menonaktifkan Panel Input dalam aplikasi bernama MyApp:

[HKEY_LOCAL_MACHINE \SOFTWARE\Microsoft\WindowsNT\TabletTIP\DisableInPlace]``"C:\Program Files\My App\MyApp.exe"=dword:00000000

Jika Anda masih melihat masalah di aplikasi setelah menonaktifkan antarmuka pengguna Panel Input, mungkin perlu untuk menonaktifkan kerangka kerja yang mendasarinya, yang meminta aplikasi Anda untuk lokasi caret. Misalnya, Panel Input dapat mengekspos bug dalam kode pelacakan caret aplikasi Anda. Menonaktifkan kueri pelacakan caret juga mencegah UI Panel Input muncul. Untuk menonaktifkan kerangka kerja, atur EnableCaretTracking kunci registri ke nol. Temukan kunci ini di HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WindowsNT\CurrentVersion\AppCompatFlags\CaretTracking\.

Catatan

Alat aksesibilitas dan teknologi ucapan di Windows XP juga menggunakan kerangka kerja ini, jadi menonaktifkan kueri juga menonaktifkan fitur-fitur ini di aplikasi Anda.

 

Panel Input dan Halaman Web

Untuk menggunakan API di halaman Web, API harus berfungsi di lingkungan kepercayaan parsial. Semua anggota kelas PenInputPanel memerlukan kepercayaan penuh kecuali yang berikut ini:

API ini berfungsi di lingkungan kepercayaan parsial, seperti halaman Web, memungkinkan Anda membuat instans objek PenInputPanel , melampirkannya ke kontrol, dan menonaktifkan Panel Input untuk kontrol tersebut. Untuk informasi selengkapnya, lihat Memprogram Panel Input Menggunakan Kelas dan Tinta PenInputPanel di Web.

Objek PenInputPanel

Topik lainnya menjelaskan cara menggunakan objek PenInputPanel di aplikasi berkemampuan PC Tablet Anda. Lebih khusus lagi, topik ini mengacu pada objek PenInputPanel saat mendiskusikan objek pemrograman, panel input pena ketika merujuk ke elemen UI, dan Panel Input PC (atau Panel Input) ketika merujuk ke panel input global yang biasanya ditemukan di sisi layar PC Tablet.

Bagian berikut menjelaskan objek dan UI PenInputPanel .