AnalysisHintNode.Guide プロパティ

2008-10-28

InkAnalyzer がこの領域内でインクの分析に使用する認識ガイドを取得または設定します。

名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink.Analysis (Microsoft.Ink.Analysis.dll 内)

構文

'宣言
Public Property Guide As RecognizerGuide
'使用
Dim instance As AnalysisHintNode
Dim value As RecognizerGuide

value = instance.Guide

instance.Guide = value

public RecognizerGuide Guide { get; set; }

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

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

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

プロパティ値

型 : Microsoft.Ink.RecognizerGuide
InkAnalyzer がこの領域内でインクの分析に使用する認識ガイド。既定値は、RecognizerGuide です。ここで、その Rows プロパティ、Columns プロパティ、および Midline プロパティは 0 で、その DrawnBox プロパティおよび WritingBox プロパティは空の四角形です。

解説

メモ :
InkAnalyzer が手書き認識に使用する Microsoft.Ink.InkRecognizer がガイドをサポートしていない場合、InkAnalyzer はガイドを無視します。InkRecognizer がサポートする機能の詳細については、InkRecognizerBase.Capabilities を参照してください。

RecognizerGuide のすべての座標はインク空間座標で、ヒントの左上隅を基準とした相対値になります。グローバルヒントの場合、ガイドは変換されず、Ink オブジェクトの座標系が使用されます。手書き認識を改善するガイドの使用の詳細については、RecognizerGuide を参照してください。

分析時、ストロークに適用されたインク認識エンジンがガイドをサポートしていない場合、インクアナライザはその WarningCode プロパティが Microsoft.Ink.AnalysisWarningCode 値 GuideNotSupported に設定された AnalysisWarning を生成します。

ヒントからガイドを削除するには、propertyDataId が PropertyGuidsForAnalysisHintsBase.Guide に設定された、ヒントの RemovePropertyData メソッドを呼び出します。ClearGuide メソッドを呼び出すことにより、ガイドを削除することもできます (既定値に設定されます)。

例

この例では、InkAnalyzer、theInkAnalyzerWithHint の AnalysisHintNode、theAnalysisHint を作成し、theAnalysisHint をグローバルヒントにします。次に、ヒントで Guide プロパティおよび Name プロパティを設定します。

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

theAnalysisHint.Guide = New RecognizerGuide(1, 0, _
    Me.theMidlineHeightInHimetric, _
    Rectangle.Inflate(Me.theGuideBoxInHimetric, 50, 50), _
    Me.theGuideBoxInHimetric)
theAnalysisHint.Name = "Recognizer Guide"

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

theAnalysisHint.Guide = new RecognizerGuide(1, 0,
    this.theMidlineHeightInHimetric,
    Rectangle.Inflate(this.theGuideBoxInHimetric, 50, 50),
    this.theGuideBoxInHimetric);
theAnalysisHint.Name = "Recognizer Guide";