InkRecognizerCoNtext 類別
能夠執行筆跡辨識、擷取辨識結果,以及擷取替代專案。 InkRecognizerCoNtext可讓安裝在系統上的各種辨識器使用筆跡辨識來適當地處理輸入。
InkRecognizerCoNtext 具有下列類型的成員:
事件
InkRecognizerCoNtext類別具有這些事件。
事件 | 描述 |
---|---|
辨識 | 當 InkRecognizerCoNtext 從 BackgroundRecognize 方法產生結果時發生。 |
RecognitionWithAlternates | 在呼叫BackgroundRecognizeWithAlternates方法之後,InkRecognizerCoNtext產生結果時發生 |
介面
InkRecognizerCoNtext類別會定義這些介面。
介面 | 描述 |
---|---|
IInkRecognizerCoNtext | 這個物件會實作 IInkRecognizerCoNtext COM 介面。 |
方法
InkRecognizerCoNtext類別具有這些方法。
方法 | 描述 |
---|---|
BackgroundRecognize | 指定辨識器應該辨識相關聯的筆劃,並在辨識完成時引發 辨識 事件。 |
BackgroundRecognizeWithAlternates | 指定辨識器應該辨識相關聯的筆劃,並在辨識完成時引發 RecognitionWithAlternates 事件。 |
複製 | 建立重複的 InkRecognizerCoNtext。 |
EndInkInput | 結束 InkRecognizerCoNtext的筆跡輸入。 |
IsStringSupported | 指出系統字典、使用者字典或 單字清單 是否包含指定的字串。 |
Recognize | 在 InkStrokes 集合上執行辨識,並傳回辨識結果。 |
StopBackgroundRecognition | 結束以呼叫 BackgroundRecognize 或 BackgroundRecognizeWithAlternates開始的背景辨識。 |
屬性
InkRecognizerCoNtext類別具有這些屬性。
屬性 | 存取類型 | 描述 |
---|---|---|
CharacterAutoCompletion |
讀取/寫入 |
取得或設定字元自動完成模式,決定辨識字元或單字的時機。 |
Factoid |
讀取/寫入 |
取得或設定 InkRecognizerCoNtext 物件所使用的 factoid 字串名稱。 |
指導 |
讀取/寫入 |
取得或設定 InkRecognizerGuide 用於筆跡輸入。 |
PrefixText |
讀取/寫入 |
取得或設定InkRecognizerCoNtext物件中InkStrokes集合之前的字元。 |
RecognitionFlags |
讀取/寫入 |
取得或設定旗標,指定辨識器如何解譯筆跡並判斷結果字串。 |
辨識器 |
讀取/寫入 |
取得或設定InkRecognizerCoNtext物件所使用的IInkRecognizer物件。 |
中風 |
讀取/寫入 |
取得或設定與InkRecognizerCoNtext物件相關聯的InkStrokes集合。 |
尾碼Text |
讀取/寫入 |
取得或設定InkRecognizerCoNtext物件中InkStrokes集合之後的字元。 |
WordList |
讀取/寫入 |
取得或設定用來改善辨識結果的 InkWordList 物件。 |
備註
此物件可以藉由在 C++ 中呼叫 CoCreateInstance 方法來具現化。
有兩種類型的辨識:背景 (非同步) 或前景 (同步) 。 背景辨識是由呼叫 BackgroundRecognize 或 BackgroundRecognizeWithAlternates 方法啟動、在背景執行緒上發生,並透過事件機制向應用程式報告結果。 在完成所有辨識之前,前景辨識不會傳回,因此讓呼叫執行緒能夠使用辨識結果,而不需要接聽辨識事件。
筆跡會在背景持續處理。 如果將IInkStrokeDisp新增至InkRecognizerCoNtext所參照的InkStrokes集合,則會立即辨識IInkStrokeDisp。 如需詳細資訊,請參閱 EndInkInput 方法主題中的備註。
所有辨識都會透過辨識器內容進行。 內容會定義單一辨識會話的設定。 它會接收必須辨識的筆跡,並定義筆跡輸入和辨識輸出的條件約束。 可以在內容上設定的條件約束包括語言、字典,以及正在使用的文法。
注意
只有在InkStrokes集合為Null時,設定 Strokes或CharacterAutoCompletion屬性以外的屬性才會成功。 您必須先設定其他屬性,才能將 InkStrokes 集合附加至 InkRecognizerCoNtext,或者您必須將 InkStrokes 集合設定為 Null ,然後設定其他屬性。 如果您將 InkStrokes 集合設定為 Null ,然後設定其他屬性,您可能必須重新附加 InkStrokes 集合。 這是因為辨識會在您將 InkStrokes 指派給 InkRecognizerCoNtext之後開始。 呼叫 Recognize 方法 [InkRecognizeCoNtext 類別] 或 BackgroundRecognize時,可能已經有呼叫結果可供使用。
若要改善應用程式的效能,請在不再需要 InkRecognizerCoNtext 物件時處置它。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows XP Tablet PC Edition [僅限傳統型應用程式] |
最低支援的伺服器 |
都不支援 |
標頭 |
|
程式庫 |
|