Memprogram Panel Input Menggunakan Kelas PenInputPanel

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

Deskripsi penggunaan objekPenInputPanel untuk memprogram Panel Input PC Tablet tingkat sistem.

Panel Input vs. Objek PenInputPanel

Di 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, objekPenInputPanelmemungkinkan 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 pada tingkat sistem telah ditingkatkan untuk memasukkan fungsi input langsung 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 ini tentang penggunaan objek PenInputPanel 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 menginstansiasi objek PenInputPanel.

Menonaktifkan Panel Input

Mungkin ada kasus di mana Anda ingin menonaktifkan Panel Input. Ada dua cara untuk mencapai hal ini. 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 instansPenInputPanel dan atur propertiAutoShow 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 banyak kontrol dalam satu aplikasi, buat instans objek PenInputPanel untuk setiap kontrol dan atur properti AutoShow ke False untuk setiap kontrol atau buat instans penInputPanel tunggal dan pindahkan dari satu kontrol ke kontrol lainnya 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. Ini dapat membuat pengalaman pengguna dalam aplikasi Anda tidak konsisten dengan aplikasi PC Tablet lainnya.

Mengatur kunci registri DisableInPlace ke nol mencegah antarmuka pengguna (UI) Panel Input muncul dalam aplikasi. Anda harus menempatkan kunci registri DisableInPlace 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 UI Panel Input, mungkin perlu untuk menonaktifkan kerangka kerja yang mendasarinya, yang meminta lokasi caret dari aplikasi Anda. Misalnya, Panel Input dapat mengekspos bug dalam kode pelacakan caret aplikasi Anda. Menonaktifkan kueri pelacakan tanda sisipan juga mencegah UI Panel Input muncul. Untuk menonaktifkan kerangka kerja, atur kunci registri EnableCaretTracking ke nol. Temukan kunci ini di HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WindowsNT\CurrentVersion\AppCompatFlags\CaretTracking\.

Nota

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 kelasPenInputPanel memerlukan kepercayaan penuh kecuali yang berikut ini:

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

Objek PenInputPanel

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

Bagian berikut menjelaskan objekPenInputPanel dan UI.

 

 

  • Last updated on