AnalysisHintNode.Guide 屬性

取得或設定 InkAnalyzer 用來分析目前區域內之筆墨的辨識器輔助線。

命名空間：  System.Windows.Ink
組件：  IAWinFX (在 IAWinFX.dll 中)

語法

'宣告
Public Property Guide As InkRecognizerGuide
'用途
Dim instance As AnalysisHintNode
Dim value As InkRecognizerGuide

value = instance.Guide

instance.Guide = value

public InkRecognizerGuide Guide { get; set; }

public:
property InkRecognizerGuide^ Guide {
    InkRecognizerGuide^ get ();
    void set (InkRecognizerGuide^ value);
}

/** @property */
public InkRecognizerGuide get_Guide()
/** @property */
public  void set_Guide(InkRecognizerGuide value)

public function get Guide () : InkRecognizerGuide
public function set Guide (value : InkRecognizerGuide)

屬性值

型別：System.Windows.Ink.InkRecognizerGuide
InkAnalyzer 用來分析目前區域內之筆墨的辨識器輔助線。預設為其所有屬性都設定為 0 的 InkRecognizerGuide。

備註

注意事項：
如果 InkAnalyzer 用於手寫辨識的 System.Windows.Ink.InkRecognizer 不支援輔助線，則 InkAnalyzer 會忽略輔助線。如需 InkRecognizer 支援之功能的詳細資訊，請參閱 InkRecognizer.Capabilities。

RecognizerGuide 的所有座標都是以筆墨空間座標表示，它們會相對於提示的左上角。對於全域提示而言，並不會轉換輔助線，因為它會使用 Ink 物件的座標系統。如需使用輔助線提升手寫辨識能力的詳細資訊，請參閱 RecognizerGuide。

在分析期間，如果套用於筆劃的筆墨分析器不支援輔助線，則筆墨分析器會產生 AnalysisWarning，而其 WarningCode() 屬性會設定為 System.Windows.Ink.AnalysisWarningCode 值 GuideNotSupported。

若要從提示移除輔助線，請呼叫 ClearGuide 方法，或呼叫提示的 RemovePropertyData(Guid) 方法並將 propertyDataId 設定為 PropertyGuidsForAnalysisHints.Guide。

範例

這個範例會為 InkAnalyzer (名為 theInkAnalyzerWithHint) 建立 AnalysisHintNode (名為 theAnalysisHint)，並且讓 theAnalysisHint 成為全域提示。然後在提示上設定 Guide 和 Name 屬性。

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

' Add a new, global analysis hint to theInkAnalyzerWithHint.
Dim theAnalysisHint As AnalysisHintNode = Me.theInkAnalyzerWithHint.CreateAnalysisHint()
theAnalysisHint.Location.MakeInfinite()

' Create an InkRecognizerGuide with the writing box
' slightly larger than the drawing box.
Dim theGuide As New InkRecognizerGuide(1, 0, midline, _
    guideBoxLeft - WRITINGBOXMARGIN, guideBoxTop - WRITINGBOXMARGIN, _
    guideBoxRight + WRITINGBOXMARGIN, guideBoxBottom + WRITINGBOXMARGIN, _
    guideBoxLeft, guideBoxTop, guideBoxRight, guideBoxBottom)

theAnalysisHint.Guide = theGuide
theAnalysisHint.Name = "Recognizer Guide"

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;

// Add a new, global analysis hint to theInkAnalyzerWithHint.
AnalysisHintNode theAnalysisHint =
    this.theInkAnalyzerWithHint.CreateAnalysisHint();
theAnalysisHint.Location.MakeInfinite();

// Create an InkRecognizerGuide with the writing box
// slightly larger than the drawing box.
InkRecognizerGuide theGuide = new InkRecognizerGuide(1, 0, midline, 
    guideBoxLeft - WRITINGBOXMARGIN, guideBoxTop - WRITINGBOXMARGIN, 
    guideBoxRight + WRITINGBOXMARGIN, guideBoxBottom + WRITINGBOXMARGIN,
    guideBoxLeft, guideBoxTop, guideBoxRight, guideBoxBottom);

theAnalysisHint.Guide = theGuide;
theAnalysisHint.Name = "Recognizer Guide";

平台

Windows Vista

.NET Framework 和 .NET Compact Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱 .NET Framework 系統需求。

版本資訊

.NET Framework

支援版本：3.0

請參閱

參考

AnalysisHintNode 類別

AnalysisHintNode 成員

System.Windows.Ink 命名空間

RecognizerGuide