共用方式為


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)。繪製方塊的界限為視覺提示,而書寫方塊的界限則是不可見的。兩者共同指定可書寫的位置。使用者通常會在繪製方塊的可見行界限內書寫。繪製方塊是由 DrawnBoxTopDrawnBoxLeftDrawnBoxBottomDrawnBoxRight 屬性指定。這些屬性僅供辨識器使用。設定這些屬性的動作本身並不會在顯示器上繪製視覺線索。您必須使用應用程式或控制項繪製視覺線索。

書寫方塊大於繪製方塊,當使用者在繪製方塊行外繪製筆墨時,可提供容錯邊界。書寫方塊是由 WritingBoxTopWritingBoxLeftWritingBoxBottomWritingBoxRight 屬性指定。

除了在螢幕上繪製用來引導使用者書寫位置的線或尺規之外,還可以在螢幕上繪製用來書寫字元或單字的儲存格,這稱為「方塊式輸入」(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

請參閱

參考

InkRecognizerGuide 成員

System.Windows.Ink 命名空間

Recognizer

RecognizerContext