次の方法で共有


InkRecognizerBase.SetAsHighestPriorityInkRecognizer メソッド

この InkRecognizerBase を、認識エンジンの InkAnalyzerBase 内部順序付きリストで最も高い優先順位に設定します。

名前空間 :  System.Windows.Ink.AnalysisCore
アセンブリ :  IACore (IACore.dll 内)

構文

'宣言
Public Sub SetAsHighestPriorityInkRecognizer
'使用
Dim instance As InkRecognizerBase

instance.SetAsHighestPriorityInkRecognizer()
public void SetAsHighestPriorityInkRecognizer()
public:
void SetAsHighestPriorityInkRecognizer()
public void SetAsHighestPriorityInkRecognizer()
public function SetAsHighestPriorityInkRecognizer()

解説

各認識エンジンには、サポートする言語とサポートする機能を示す値が含まれています。使用可能な認識エンジンを順序付きリストに編成することにより、InkAnalyzerBase は、複数の認識エンジンが同じ言語および機能の両方をサポートする場合に使用する認識エンジンを決定できます。InkAnalyzerBase には、認識エンジンの内部順序付きリストが格納されます。内部順序付きリストは、呼び出されるたびに動的に設定されます。

ms615415.alert_note(ja-jp,VS.90).gifメモ :

レジストリへのアクセスが原因でパフォーマンスが低下する場合、InkAnalyzerBase が作成されたときにレジストリ値の確認のみを行うようにこれを制限できます。

内部リストの順序付けは、次のロジックに基づいて決定されます。

  1. "Recognizers Precedence" レジストリ キーの値を調べることにより、コントロール パネル アプリケーションが順序を設定したかどうかを確認します。

    1. "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\TPG\Recognizers Precedence"

    2. 各認識エンジンは、GUID によりレジストリ サブキーとして示されます。

    3. 各レジストリ サブキーには "Order" という dword 値があります。この値は、0 から始まる順序付けです (0 = 使用する最初の認識エンジン、1 = 使用する 2 番目の認識エンジン… n = 使用する最後の認識エンジン)。

    4. "Recognizers Precedence" キーが存在しない場合、または破損している場合は、次の手順にスキップします。

  2. "System Recognizer" レジストリ キーを確認することにより、インストールされたすべての Microsoft 認識エンジンが順序付けリストに示されているかどうかを確認します。システムで見つかったが、順序付けリストには含まれていない Microsoft 認識エンジンはすべて、見つかった順序でリストの末尾に追加されます。

  3. "System Recognizer" レジストリ キーを確認することにより、インストールされたすべての外部 (サードパーティ) 認識エンジンが順序付けリストに示されているかどうかを確認します。システムで見つかったが、順序付けリストには含まれていない外部認識エンジンはすべて、見つかった順序でリストの末尾に追加されます。

既定の順序付けが構築されたら、アプリケーションはこのメソッドを呼び出して、リストの一番上に認識エンジンを昇格させることにより、既定の順序を変更またはオーバーライドできます。

認識エンジンの使用は、リスト内のそれらの順序に基づいて評価されます。

  • パーサーは、リスト内の最初の認識エンジンから開始されます。

  • 最初の認識エンジンは、認識するインクの言語および機能をサポートするかどうかがテストされます。

  • サポートする場合は、その認識エンジンが使用されます。

  • サポートしない場合は、リスト内の次の認識エンジンがチェックされます。認識エンジンが見つかるか、リスト内に残りの認識エンジンがなくなるまで繰り返されます。

  • 認識エンジンが見つからない場合、TPG_No_Suitable_Recognizer_Found 例外が返されます。

プラットフォーム

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。

バージョン情報

.NET Framework

サポート対象 : 3.0

参照

参照

InkRecognizerBase クラス

InkRecognizerBase メンバ

System.Windows.Ink.AnalysisCore 名前空間