Metode IInkRecognizerContext::get_Guide (msinkaut.h)

Artikel
08/25/2023

Mendapatkan atau mengatur InkRecognizerGuide untuk digunakan untuk input tinta.

Properti ini bersifat baca/tulis.

Sintaks

HRESULT get_Guide(
  IInkRecognizerGuide **RecognizerGuide
);

Parameter

RecognizerGuide

Menampilkan nilai

Tidak ada

Keterangan

Mengatur properti Panduan hanya berhasil jika koleksi InkStrokes adalah NULL. Anda harus mengatur properti Panduan sebelum melampirkan koleksi InkStrokes ke InkRecognizerContext atau Anda harus mengatur koleksi InkStrokes ke NULL lalu mengatur Panduan (dan kemungkinan pemasangan ulang koleksi InkStrokes).

Enumerasi InkRecognizerCapabilities berisi bendera IRC_FreeInput, IRC_LinedInput, dan IRC_BoxedInput . Bendera ini menentukan kemampuan pengenal, tetapi karena hanya dibaca, tidak ada cara untuk mengatur salah satu dari ini langsung pada objek IInkRecognizer atau InkRecognizerContext . Satu-satunya cara untuk memasukkan pengenal ke dalam mode tertentu adalah dengan mengatur panduan menggunakan properti Panduan . Jika Anda tidak mengatur properti Panduan , recognizer default ke mode FreeInput (jika recognizer mampu melakukan ini). Cara lain untuk mengatur pengenal ke mode FreeInput adalah dengan mengatur properti Panduan ke objek InkRecognizerGuide yang properti Kolomnya diatur ke nol dan properti Barisnya diatur ke nol.

Jika Anda mengatur properti Panduan ke objek InkRecognizerGuide yang properti Kolomnya diatur ke nol dan properti Barisnya diatur ke 1 atau lebih, pengenal berada dalam mode IRC_LinedInput (jika pengenal mampu melakukannya). Pengenal menggunakan properti Baris untuk mengontrol jumlah baris.

Jika Anda mengatur properti Panduan ke objek InkRecognizerGuide yang properti Barisnya diatur ke nol dan properti Kolomnya diatur ke 1 atau lebih, pengenal berada dalam mode IRC_LinedInput (jika pengenal mampu) untuk penulisan vertikal. Pengenal menggunakan properti Kolom untuk mengontrol jumlah garis vertikal. Jika recognizer mampu melakukan ini, properti Kemampuan objek IInkRecognizer mengembalikan IRC_DownAndLeft atau IRC_DownAndRight, atau keduanya.

Jika Anda mengatur properti Panduan ke objek InkRecognizerGuide yang properti Kolomnya diatur ke 1 atau lebih dan properti Barisnya diatur ke 1 atau lebih, pengenal berada dalam mode IRC_BoxedInput (jika pengenal mampu melakukannya).

Jika Anda mengatur mode ke mode yang tidak tersedia dari recognizer ini, kesalahan akan ditampilkan.

Untuk informasi tentang cara mengkueri kapabilitas, atau mode mana, yang tersedia dari pengenal tertentu, lihat properti Kemampuan objek IInkRecognizer . Secara umum, pengenal skrip Latin mendukung input gratis dan input bergaris horizontal, pengenal karakter Asia Timur mendukung input gratis dan input kotak, dan pengenal gerakan hanya mendukung input gratis.

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	msinkaut.h
Pustaka	InkObj.dll