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