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 です。
解説
.gif "メモ") メモ : |
|---|
InkAnalyzer が手書き認識に使用する System.Windows.Ink.InkRecognizer がガイドをサポートしていない場合、InkAnalyzer はガイドを無視します。InkRecognizer がサポートする機能の詳細については、InkRecognizer.Capabilities を参照してください。 |
RecognizerGuide のすべての座標はインク空間座標で、ヒントの左上隅を基準とした相対値になります。グローバル ヒントの場合、ガイドは変換されません。これは、Ink オブジェクトの座標系が使用されるためです。手書き認識を改善するガイドの使用の詳細については、RecognizerGuide を参照してください。
分析時、ストロークに適用されたインク認識エンジンがガイドをサポートしていない場合、インク アナライザはその WarningCode() プロパティが System.Windows.Ink.AnalysisWarningCode 値 GuideNotSupported に設定された AnalysisWarning を生成します。
ヒントからガイドを削除するには、ClearGuide メソッド、または propertyDataId が PropertyGuidsForAnalysisHints.Guide に設定された、ヒントの RemovePropertyData(Guid) メソッドを呼び出します。
例
この例では、(theInkAnalyzerWithHint という名前の) InkAnalyzer の (theAnalysisHint という名前の) AnalysisHintNode を作成し、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
参照
参照
RecognizerGuide