Bagikan melalui


Fungsi SetFlags (recapis.h)

Menentukan bagaimana pengenal menginterpretasikan tinta dan menentukan string hasil.

Panggil fungsi ini sebelum memproses tinta untuk pertama kalinya. Oleh karena itu, panggil fungsi SetFlags sebelum memanggil fungsi Proses .

Sintaks

HRESULT SetFlags(
  [in] HRECOCONTEXT hrc,
  [in] DWORD        dwFlags
);

Parameter

[in] hrc

Menangani konteks recognizer.

[in] dwFlags

Tabel berikut mencantumkan bendera yang dapat Anda atur untuk menentukan bagaimana pengenal menginterpretasikan tinta dan menentukan string hasil. Gunakan operator OR (|) untuk menggabungkan bendera yang sesuai.

Bendera bit Makna
RECOFLAG_AUTOSPACE
Recognizer menggunakan penspasian cerdas berdasarkan aturan model bahasa.
RECOFLAG_COERCE
Recognizer memaksa hasil berdasarkan factoid yang Anda tentukan untuk konteksnya. Misalnya, jika Anda menentukan factoid nomor telepon dan pengguna memasukkan kata "hello", pengenal dapat mengembalikan nomor telepon acak atau string kosong. Jika Anda tidak menentukan bendera ini, pengenal akan mengembalikan "hello" sebagai hasilnya.
RECOFLAG_PREFIXOK
Recognizer mendukung pengenalan bagian awalan dari string yang ditentukan dalam model bahasa default atau yang ditentukan (factoid).

Misalnya, tanpa bendera ini, pengguna menulis "handw" dan recognizer mengembalikan saran (seperti "hander" atau "handed") yang merupakan kata-kata yang ada di leksikon recognizer. Dengan bendera , pengenal dapat mengembalikan "handw" sebagai salah satu saran karena ini adalah awalan yang valid dari kata "tulisan tangan" yang ada dalam leksikon pengenal.

Panel Input PC Tablet mengatur bendera ini dalam banyak kasus, kecuali ketika cakupan input IS_DEFAULT (atau tidak ada cakupan input) atau ketika tidak ada daftar kata pengguna atau ekspresi reguler.

Pengenal karakter Asia Timur harus mengembalikan E_INVALIDARG ketika penelepon melewati bendera ini.

RECOFLAG_LINEMODE
Pengenal tidak membagi baris tetapi harus tetap melakukan pemisahan karakter dan kata. Ini sama dengan mode berjajar, kecuali bahwa tidak ada panduan, dan semua tinta diasumsikan berada dalam satu baris. Saat bendera ini diatur, panduan, jika diatur, diabaikan.
RECOFLAG_SINGLESEG
Menonaktifkan beberapa segmentasi. Secara default, recognizer mengembalikan beberapa segmentasi (alternatif) untuk tinta.

Misalnya, jika Anda menulis "bersama" sebagai goresan terpisah, pengenal dapat membasmi tinta sebagai "untuk mendapatkannya", "untuk mengumpulkan", atau "bersama". Atur bendera ini jika Anda tidak memerlukan beberapa segmentasi tinta saat Anda meminta alternatif. Ini meningkatkan performa dan mengurangi penggunaan memori.

RECOFLAG_WORDMODE
Recognizer memperlakukan tinta sebagai satu kata. Misalnya, jika konteks berisi "untuk mendapatkannya", pengenal mengembalikan "bersama".

Nilai kembali

Fungsi ini dapat mengembalikan salah satu nilai ini.

Nilai HRESULT Deskripsi
S_OK
Berhasil.
E_INVALIDARG
Bendera tidak valid.
E_NOTIMPL
Recognizer tidak mendukung fungsi ini.
E_OUTOFMEMORY
Tidak dapat mengalokasikan memori untuk menyelesaikan operasi.
E_FAIL
Terjadi kesalahan yang tidak ditentukan.
E_POINTER
Konteks tidak valid atau salah satu parameter adalah penunjuk yang tidak valid.

Keterangan

Sebelum Microsoft Windows XP Tablet PC Edition Development Kit 1.7, Panel Input PC Tablet melakukan penspasian cerdas. Dimulai dengan Tablet PC SDK 1.7, Panel Input terus menghasilkan hasil dengan rekomendasi penspasian awal. Namun, hasil spasi Panel Input PC Tablet dapat diubah oleh rekomendasi pengenal (hasil). Pengenal dapat melakukan ini dengan menggunakan informasi kontekstual teks (berdasarkan panggilan SetTextContext yang dibuat oleh Panel Input) dan aturan model bahasa internalnya.

Panel Input dapat menentukan apakah pengenal mampu melakukan penspasian otomatis dengan memanggil fungsi ini dengan set bendera RECOFLAG_AUTOSPACE. Jika pengenal tidak mendukung penspasian otomatis, E_INVALIDARG dikembalikan.

Catatan Hanya mode baris yang didukung dalam fungsi SetFlags . Mode kotak, mode bebas, dan mode baris tunggal tidak didukung.
 

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP Tablet PC Edition [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Tidak ada yang didukung
Target Platform Windows
Header recapis.h
DLL inkobjcore.dll

Lihat juga

Fungsi SetFactoid

SetTextContext Function