InkRecognizerGuide クラス

インクを描画できる認識エンジンが使用する領域を表します。 この領域は認識ガイドと呼ばれます。

InkRecognizerGuide には、次の種類のメンバーがあります。

• インターフェイス
• プロパティ

インターフェイス

InkRecognizerGuide クラスは、これらのインターフェイスを定義します。

インターフェイス	説明
IInkRecognizerGuide	このオブジェクトは 、IInkRecognizerGuide COM インターフェイスを実装します。

プロパティ

InkRecognizerGuide クラスには、これらのプロパティがあります。

プロパティ	アクセスの種類	説明
[列]	読み取り/書き込み	ガイド ボックスの列数を取得または設定します。
DrawnBox	読み取り/書き込み	タブレットの画面に物理的に描画され、書き込みが行われるボックスを取得または設定します。
GuideData	読み取り/書き込み	C++ 開発者向けのガイド データを取得または設定します。
正中 線	読み取り/書き込み	中間線の高さを取得または設定します。 中央線の高さは、描画ボックスの基準線から中線までの距離です。
行	読み取り/書き込み	ガイド ボックスの行数を取得または設定します。
WritingBox	読み取り/書き込み	実際に書き込みを行うことができるガイド ボックスの非表示の書き込み領域を取得または設定します。

解説

このオブジェクトは、 CoCreateInstance メソッドを呼び出すことによってインスタンス化できます。

既定では、認識エンジン ガイドはありません。 既定のガイドでは、すべてのプロパティ値が 0 に設定されています。 ガイドを設定するには、このオブジェクトのプロパティを使用する必要があります。

ユーザーが書き込む必要がある画面上にアプリケーションがガイドラインを作成している場合、アプリケーションは認識エンジンに通知するために、認識エンジン ガイドのプロパティの値を設定する必要があります。 これらのプロパティは、認識エンジンでのみ使用されます。 設定だけでは、ディスプレイに視覚的な手がかりは描画されません。 アプリケーションまたはコントロールによって視覚的な手掛かりが描画されます。

認識エンジン ガイドは行と列で構成でき、これらは認識エンジンに認識を実行するためのより良いコンテキストを提供します。 "t" や "I" などの文字は、ガイドを使用してインクにコンテキストを与えるときにより簡単に認識されます。 たとえば、画面上に水平線を描画して、書き込みが行われる場所を示すことができます (この種類のガイドは行のみで構成され、列は含まれない)。 行に書き込むことで、任意のスペースではなく、認識精度が向上します。

このガイドでは、インク空間座標内のインクの境界を指定します。

DrawnBox プロパティは、WritingBox プロパティで定義されているボックスと同じサイズまたは小さいボックスを定義できます。

次の図は、2 つの行と列のない認識エンジン ガイドの要素を示しています。

ユーザーが書き込む場所を示す線を画面上に描画するだけでなく、文字や単語を書き込むセルを画面上に描画することもできます。 これはボックス化された入力と呼ばれ、一部のアジア言語で役立ちます。 認識エンジンがボックス化された入力に対応しているかどうかを判断するには、IInkRecognizer オブジェクトの Capabilities プロパティを呼び出します。

次の図は、4 つの列を含む認識エンジン ガイドを示しています。

必要条件

要件	値
サポートされている最小のクライアント	Windows XP タブレット PC エディション [デスクトップ アプリのみ]
サポートされている最小のサーバー	サポートなし
Header	Msinkaut.h (Msinkaut_i.c も必要)
ライブラリ	InkObj.dll

関連項目

IInkRecognizer インターフェイス

InkRecognizerContext クラス