Kelas InkRecognizerContext

Memungkinkan kemampuan untuk melakukan pengenalan tinta, mengambil hasil pengenalan, dan mengambil alternatif. InkRecognizerContext memungkinkan berbagai pengenal yang diinstal pada sistem untuk menggunakan pengenalan tinta untuk memproses input dengan tepat.

InkRecognizerContext memiliki jenis anggota ini:

Acara

Kelas InkRecognizerContext memiliki peristiwa ini.

Kejadian Deskripsi
Pengenalan Terjadi ketika InkRecognizerContext telah menghasilkan hasil dari metode BackgroundRecognize.
RecognitionWithAlternates Terjadi ketika InkRecognizerContext telah menghasilkan hasil setelah memanggil metode BackgroundRecognizeWithAlternates

Antarmuka

Kelas InkRecognizerContext mendefinisikan antarmuka ini.

Antarmuka Deskripsi
IInkRecognizerContext Objek ini mengimplementasikan antarmuka IInkRecognizerContext COM.

Metode

Kelas InkRecognizerContext memiliki metode ini.

Metode Deskripsi
BackgroundRecognize Menentukan bahwa pengenal harus mengenali goresan terkait dan menembakkan peristiwa Pengenalan saat pengenalan selesai.
BackgroundRecognizeWithAlternates Menentukan bahwa pengenal harus mengenali goresan terkait dan mengaktifkan peristiwa RecognitionWithAlternates saat pengenalan selesai.
Kloning Membuat InkRecognizerContext duplikat.
EndInkInput Mengakhiri input tinta ke InkRecognizerContext.
IsStringSupported Menunjukkan apakah kamus sistem, kamus pengguna, atau daftar kata berisi string yang ditentukan.
Recognize Melakukan pengenalan pada koleksi InkStrokes dan mengembalikan hasil pengenalan.
StopBackgroundRecognition Mengakhiri pengenalan latar belakang yang dimulai dengan panggilan ke BackgroundRecognize atau BackgroundRecognizeWithAlternates.

Properti

Kelas InkRecognizerContext memiliki properti ini.

Properti Jenis akses Deskripsi
CharacterAutoCompletion
Baca/Tulis
Mendapatkan atau mengatur karakter mode Lengkapi Otomatis, yang menentukan kapan karakter atau kata dikenali.
Factoid
Baca/Tulis
Mendapatkan atau mengatur nama string factoid yang digunakan oleh objek InkRecognizerContext .
Panduan
Baca/Tulis
Mendapatkan atau mengatur InkRecognizerGuide untuk digunakan untuk input tinta.
PrefixText
Baca/Tulis
Mendapatkan atau mengatur karakter yang datang sebelum koleksi InkStrokes di objek InkRecognizerContext .
RecognitionFlags
Baca/Tulis
Mendapatkan atau mengatur bendera yang menentukan bagaimana pengenal menginterpretasikan tinta dan menentukan string hasil.
Pengenal
Baca/Tulis
Mendapatkan atau mengatur objek IInkRecognizer yang digunakan oleh objek InkRecognizerContext .
Stroke
Baca/Tulis
Mendapatkan atau mengatur koleksi InkStrokes yang terkait dengan objek InkRecognizerContext .
AkhiranTeks
Baca/Tulis
Mendapatkan atau mengatur karakter yang muncul setelah koleksi InkStrokes di objek InkRecognizerContext .
Daftar Kata
Baca/Tulis
Mendapatkan atau mengatur objek InkWordList yang digunakan untuk meningkatkan hasil pengenalan.

Keterangan

Objek ini dapat dibuat dengan memanggil metode CoCreateInstance di C++.

Ada dua jenis pengenalan: latar belakang (asinkron) atau latar depan (sinkron). Pengenalan latar belakang dimulai dengan panggilan ke metode BackgroundRecognize atau BackgroundRecognizeWithAlternates , terjadi pada utas latar belakang, dan melaporkan hasil ke aplikasi melalui mekanisme peristiwa. Pengenalan latar depan tidak kembali sampai semua pengenalan selesai, sehingga membuat hasil pengenalan tersedia untuk utas panggilan tanpa mendengarkan peristiwa pengenalan.

Tinta diproses terus-menerus di latar belakang. Jika IInkStrokeDisp ditambahkan ke koleksi InkStrokes yang dirujuk oleh InkRecognizerContext , maka IInkStrokeDisp kemudian segera dikenali. Lihat keterangan dalam topik metode EndInkInput untuk detail selengkapnya.

Semua pengenalan terjadi melalui konteks pengenal. Konteks menentukan pengaturan untuk satu sesi pengenalan. Ini menerima tinta yang harus dikenali dan menentukan batasan pada input tinta dan pada output pengenalan. Batasan yang dapat diatur pada konteks termasuk bahasa, kamus, dan tata bahasa yang sedang digunakan.

Catatan

Mengatur properti selain properti Strokes atau CharacterAutoCompletion hanya berhasil jika koleksi InkStrokes adalah NULL. Anda harus mengatur properti lain sebelum melampirkan koleksi InkStrokes ke InkRecognizerContext, atau Anda harus mengatur koleksi InkStrokes ke NULL lalu mengatur properti lainnya. Jika Anda mengatur koleksi InkStrokes ke NULL lalu mengatur properti lainnya, Anda mungkin harus memasang kembali koleksi InkStrokes. Ini karena pengenalan dimulai tepat setelah Anda menetapkan InkStrokes ke InkRecognizerContext. Ketika panggilan dilakukan ke Recognize Method [InkRecognizeContext Class] atau BackgroundRecognize, hasil panggilan mungkin sudah tersedia.

Untuk meningkatkan performa aplikasi Anda, buang objek InkRecognizerContext Anda saat tidak lagi diperlukan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
Windows XP Tablet PC Edition [hanya aplikasi desktop]
Server minimum yang didukung
Tidak ada yang didukung
Header
Msinkaut.h (juga memerlukan Msinkaut_i.c)
Pustaka
InkObj.dll

Lihat juga

Antarmuka IInkRecognizer

Koleksi InkStrokes