InkRecognizerGuide 類別
表示 InkRecognizer 物件所使用,而且能在其中繪製筆墨的區域。這個區域稱為「辨識器輔助線」(recognizer guide)。
命名空間: System.Windows.Ink
組件: IAWinFX (在 IAWinFX.dll 中)
語法
'宣告
Public Class InkRecognizerGuide
'用途
Dim instance As InkRecognizerGuide
public class InkRecognizerGuide
public ref class InkRecognizerGuide
public class InkRecognizerGuide
public class InkRecognizerGuide
備註
InkRecognizerGuide 可由列和欄組成,提供更好的內容讓辨識器執行辨識。例如,您可以在使用者的螢幕上繪製多條水平線,就像有橫隔線的紙張一樣,用來顯示筆墨應該出現的位置 (這類的輔助線只由列組成,而沒有欄)。如果使用者逐行書寫,而非任意間隔書寫,則辨識的正確性便可提高。例如,當使用輔助線為筆墨提供內容時,會更容易辨識出 "t"、"I" 之類的字母。
InkRecognizerGuide 會藉由定義下列兩個矩形,指定可繪製筆墨的界限:「繪製方塊」(drawn box) 和「書寫方塊」(writing box)。繪製方塊的界限為視覺提示,而書寫方塊的界限則是不可見的。兩者共同指定可書寫的位置。使用者通常會在繪製方塊的可見行界限內書寫。繪製方塊是由 DrawnBoxTop、DrawnBoxLeft、DrawnBoxBottom 及 DrawnBoxRight 屬性指定。這些屬性僅供辨識器使用。設定這些屬性的動作本身並不會在顯示器上繪製視覺線索。您必須使用應用程式或控制項繪製視覺線索。
書寫方塊大於繪製方塊,當使用者在繪製方塊行外繪製筆墨時,可提供容錯邊界。書寫方塊是由 WritingBoxTop、WritingBoxLeft、WritingBoxBottom 和 WritingBoxRight 屬性指定。
除了在螢幕上繪製用來引導使用者書寫位置的線或尺規之外,還可以在螢幕上繪製用來書寫字元或單字的儲存格,這稱為「方塊式輸入」(boxed input),對於東亞語系非常有用。若要判斷辨識器是否有能力處理方塊式輸入,請呼叫 InkRecognizer 物件的 Capabilities 屬性。
根據預設,輔助線的所有屬性值都是設定為 0,表示沒有輔助線。您必須使用 InkRecognizerGuide 物件的屬性來設定輔助線。
範例
下列動作會同時設定 InkRecognizerGuide 中的所有值。
Dim guideBoxTop As Double = 0
Dim guideBoxBottom As Double = 50
Dim guideBoxLeft As Double = 0
Dim guideBoxRight As Double = 600
Dim WRITINGBOXMARGIN As Integer = 10
' Find the midline of the guide box.
Dim midline As Double = (guideBoxBottom - guideBoxTop) / 2 + guideBoxTop
theGuide.Rows = 1
theGuide.Columns = 0
theGuide.Midline = midline
theGuide.WritingBoxLeft = guideBoxLeft - WRITINGBOXMARGIN
theGuide.WritingBoxTop = guideBoxTop - WRITINGBOXMARGIN
theGuide.WritingBoxRight = guideBoxRight + WRITINGBOXMARGIN
theGuide.WritingBoxBottom = guideBoxBottom + WRITINGBOXMARGIN
theGuide.DrawnBoxLeft = guideBoxLeft
theGuide.DrawnBoxTop = guideBoxTop
theGuide.DrawnBoxRight = guideBoxRight
theGuide.DrawnBoxBottom = guideBoxBottom
double guideBoxTop = 0;
double guideBoxBottom = 50;
double guideBoxLeft = 0;
double guideBoxRight = 600;
const int WRITINGBOXMARGIN = 10;
// Find the midline of the guide box.
double midline = (guideBoxBottom - guideBoxTop) / 2 + guideBoxTop;
theGuide.Rows = 1;
theGuide.Columns = 0;
theGuide.Midline = midline;
theGuide.WritingBoxLeft = guideBoxLeft - WRITINGBOXMARGIN;
theGuide.WritingBoxTop = guideBoxTop - WRITINGBOXMARGIN;
theGuide.WritingBoxRight = guideBoxRight + WRITINGBOXMARGIN;
theGuide.WritingBoxBottom = guideBoxBottom + WRITINGBOXMARGIN;
theGuide.DrawnBoxLeft = guideBoxLeft;
theGuide.DrawnBoxTop = guideBoxTop;
theGuide.DrawnBoxRight = guideBoxRight;
theGuide.DrawnBoxBottom = guideBoxBottom;
繼承階層架構
System.Object
System.Windows.Ink.InkRecognizerGuide
執行緒安全
這個型別的任何 Public static (在 Visual Basic 中為 Shared) 成員都具備執行緒安全。並非所有的執行個體成員都是安全執行緒。
平台
Windows Vista
.NET Framework 和 .NET Compact Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊,請參閱 .NET Framework 系統需求。
版本資訊
.NET Framework
支援版本:3.0
請參閱
參考
Recognizer
RecognizerContext