Recognizers.GetDefaultRecognizer メソッド (Int32)

2008-10-28

国別言語サポート (NLS) の言語コード識別子 (LCID) によって指定された既知の言語の、既定の認識エンジンを返します。

名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)

構文

'宣言
Public Function GetDefaultRecognizer ( _
    lcid As Integer _
) As Recognizer
'使用
Dim instance As Recognizers
Dim lcid As Integer
Dim returnValue As Recognizer

returnValue = instance.GetDefaultRecognizer(lcid)

public Recognizer GetDefaultRecognizer(
    int lcid
)

public:
Recognizer^ GetDefaultRecognizer(
    int lcid
)

public Recognizer GetDefaultRecognizer(
    int lcid
)

public function GetDefaultRecognizer(
    lcid : int
) : Recognizer

パラメータ

lcid
型 : System.Int32
既定の認識エンジンを取得する言語の言語コード識別子 (LCID)。

値	説明
0	このメソッドは、ユーザーのロケール設定を使用して、取得する既定の認識エンジンを判断します。ユーザーの地域のオプションでロケールが指定されていない場合は、コンピュータに対して指定されているロケールを使用します。
System.Int32	このメソッドは、ロケール識別子を使用して、取得する既定の認識エンジンを判断します。

戻り値

型 : Microsoft.Ink.Recognizer
要求された認識エンジンを返します。

解説

言語ごとに、既定の認識エンジンを設定できます。たとえば、1 人のユーザーに対して英語 (米国) の既定の認識エンジンとフランス語の既定の認識エンジンを設定することができます。ロケールが指定されていない場合、このメソッドはアクティブな入力ロケールの認識エンジンを返します。アクティブな入力ロケールを選択するには、[コントロールパネル] の [地域と言語のオプション] の [言語] タブの [詳細] をクリックし、[既定の言語] を選択します。

国別言語サポート (NLS) の詳細については、「NLS の用語」を参照してください。

このメソッドは、LCID が既知のロケールでない場合や、要求したロケールの認識エンジンがインストールされていない場合に、例外をスローします。ロケールを持たない言語の認識エンジンを検索するには、Recognizers コレクションの要素を列挙して、各 Recognizer オブジェクトの Languages プロパティを確認します。LCID の表については、言語識別子の表を参照してください。Microsoft® 認識エンジンの一覧については、「Using the Recognizers Collection」を参照してください。

例

この C# の例では、日本語の LCID を使用して日本語の既定の認識エンジンを取得し、Recognizer オブジェクト recoDefault を使用してその認識エンジンを表します。

using Microsoft.Ink;
// . . .
Recognizers theRecognizers = new Recognizers();
int theLCID = 0x0411;
// Get the default recognizer for Japanese.
Recognizer recoDefault = theRecognizers.GetDefaultRecognizer(theLCID);

この Microsoft Visual Basic® .NET の例では、日本語の LCID を使用して日本語の既定の認識エンジンを取得し、Recognizer オブジェクト recoDefault を使用してその認識エンジンを表します。

Imports Microsoft.Ink
' . . .
Dim theRecognizers As Recognizers = New Recognizers()
Dim recoDefault As Recognizer
Dim theLCID As Integer = &H411   ' The LCID for Japanese
'Get the default recognizer for Japanese.
recoDefault = theRecognizers.GetDefaultRecognizer(theLCID)