IInkRecognizers::GetDefaultRecognizer メソッド (msinkaut.h)
各国語サポート (NLS) 言語コード識別子 (LCID) で指定された既知の言語の既定の認識エンジンを取得します。
構文
HRESULT GetDefaultRecognizer(
[in] long lcid,
[out, retval] IInkRecognizer **DefaultRecognizer
);
パラメーター
[in] lcid
既定の認識エンジンを取得する言語の LCID ロケール識別子。 lcid が 0 の場合、メソッドはユーザーのロケール設定を使用して、取得する既定の認識エンジンを決定します。 ユーザーが地域オプションでロケールを指定していない場合、メソッドはコンピューターに指定されたロケールを使用します。 既定値は 0 です。
[out, retval] DefaultRecognizer
このメソッドが返されるときに、 には、要求された認識エンジンへのポインターが含まれます。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
正常終了しました。 |
|
パラメーターに無効なポインターが含まれていました。 |
|
メソッド内で例外が発生しました。 |
|
フラグが無効です。 |
|
予期しないパラメーターまたはプロパティの型。 |
解説
各言語には、既定の認識エンジンを使用できます。 たとえば、ユーザーは、米国英語の既定の認識エンジンとフランス語の既定の認識エンジンを持つことができます。 ロケールが指定されていない場合、このメソッドはアクティブな入力ロケールの認識エンジンを返します。 アクティブな入力ロケールを選択するには、ControlPanel の [地域と言語のオプション] の [言語] タブで、[詳細] をクリックし、[既定の入力言語] を選択します。
lcid パラメーターの既定値は 0 です。
lcid パラメーターが既知のロケールではない場合、または要求されたロケールに認識エンジンがインストールされていない場合、このメソッドはエラーを生成します。
GetDefaultRecognizer は、まず、ユーザーの入力ロケールに一致する認識エンジンがあるかどうかを確認します。 存在しない場合は、現在のシステム ロケールに一致する認識エンジンがあるかどうかを確認します。
NLS の詳細については、「 NLS の用語」を参照してください。
要件
| サポートされている最小のクライアント | Windows XP タブレット PC エディション [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | msinkaut.h |
| Library | InkObj.dll |