IInkRecognizerContext::get_Guide メソッド (msinkaut.h)
インク入力に使用する InkRecognizerGuide を取得または設定します。
このプロパティは読み取り/書き込み可能です。
構文
HRESULT get_Guide(
IInkRecognizerGuide **RecognizerGuide
);
パラメーター
RecognizerGuide
戻り値
なし
解説
Guide プロパティの設定は、InkStrokes コレクションが NULL の場合にのみ成功します。 InkStrokes コレクションを InkRecognizerContext にアタッチする前に Guide プロパティを設定する必要があります。または、InkStrokes コレクションを NULL に設定してから、Guide を設定する必要があります (InkStrokes コレクションを再アタッチすることもできます)。
InkRecognizerCapabilities 列挙には、IRC_FreeInput、IRC_LinedInput、およびIRC_BoxedInputフラグが含まれています。 これらのフラグは認識エンジンの機能を指定しますが、読み取り専用であるため、IInkRecognizer オブジェクトまたは InkRecognizerContext オブジェクトに直接設定する方法はありません。 認識エンジンを特定のモードにする唯一の方法は、 Guide プロパティを使用してガイドを設定することです。 Guide プロパティを設定しない場合、認識エンジンの既定値は FreeInput モードになります (認識エンジンがこれに対応している場合)。 認識エンジンを FreeInput モードに設定するもう 1 つの方法は、Guide プロパティを、Columns プロパティが 0 に設定され、Rows プロパティが 0 に設定されている InkRecognizerGuide オブジェクトに設定することです。
Guide プロパティを、Columns プロパティが 0 に設定され、Rows プロパティが 1 以上に設定されている InkRecognizerGuide オブジェクトに設定した場合、認識エンジンはIRC_LinedInput モードになります (認識エンジンがこれに対応している場合)。 認識エンジンは Rows プロパティを使用して行数を制御します。
Guide プロパティを、Rows プロパティが 0 に設定され、Columns プロパティが 1 以上に設定されている InkRecognizerGuide オブジェクトに設定すると、認識エンジンは垂直方向の書き込みに対してIRC_LinedInput モードになります (認識エンジンがこれに対応している場合)。 認識エンジンは Columns プロパティを使用して垂直線の数を制御します。 認識エンジンがこれに対応している場合、 IInkRecognizer オブジェクトの Capabilities プロパティは 、IRC_DownAndLeft または IRC_DownAndRight、またはその両方を返します。
Guide プロパティを、Columns プロパティが 1 以上に設定され、Rows プロパティが 1 以上に設定されている InkRecognizerGuide オブジェクトに設定した場合、認識エンジンはIRC_BoxedInput モードになります (認識エンジンがこれに対応している場合)。
モードをこの認識エンジンから使用できないモードに設定すると、エラーが返されます。
特定の認識エンジンから使用できる機能またはモードを照会する方法については、IInkRecognizer オブジェクトの Capabilities プロパティを参照してください。 一般に、ラテン スクリプトの認識エンジンは、無料の入力と水平に並んだ入力をサポートし、東アジアの文字の認識エンジンは無料の入力とボックス化された入力をサポートし、ジェスチャ認識エンジンは無料の入力のみをサポートします。
要件
| サポートされている最小のクライアント | Windows XP タブレット PC エディション [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | msinkaut.h |
| Library | InkObj.dll |