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" などの文字がより認識されやすくなります。
2 つの四角形 drawn box (描画ボックス) と writing box (手書きボックス) を定義することで、InkRecognizerGuide はインクを描画できる境界を指定します。描画ボックスの境界は視覚的なヒントであり、手書きボックスの境界は表示されません。これらを合わせて、手書きが行われる場所が指定されます。ユーザーは通常、描画ボックスに表示される線の境界内に書き込みます。描画ボックスは、DrawnBoxTop、DrawnBoxLeft、DrawnBoxBottom、および DrawnBoxRight の各プロパティで指定されます。これらのプロパティは、認識エンジンによってのみ使用されます。これらのプロパティを設定すること自体により、画面に視覚的なヒントが描画されるわけではありません。視覚的なヒントは、アプリケーションまたはコントロールを使用して描画する必要があります。
手書きボックスは、描画ボックスより大きいため、ユーザーが描画ボックスの線の外側にインクを描画した場合の許容誤差となります。手書きボックスは、WritingBoxTop、WritingBoxLeft、WritingBoxBottom、および WritingBoxRight の各プロパティで指定されます。
手書きを行う場所をユーザーに示す線や罫線を画面に描画することに加えて、文字または単語が書き込まれるセルを画面に描画することもできます。これは 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
スレッド セーフ
この型のすべてのパブリック static (Visual Basic では Shared) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォーム
Windows Vista
.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
バージョン情報
.NET Framework
サポート対象 : 3.0
参照
参照
Recognizer
RecognizerContext