次の方法で共有

IInkAnalyzer インターフェイス

  • [アーティクル]

レイアウト分析、書き込みと描画の分類、手書き認識へのアクセスを提供します。

メンバー

IInkAnalyzer インターフェイスは、IUnknown インターフェイスから継承されます。 IInkAnalyzer には、次の種類のメンバーもあります。

メソッド

IInkAnalyzer インターフェイスには、これらのメソッドがあります。

メソッド 説明
中止 現在の分析操作を取り消します。
AddStroke 1 回のストロークのストローク データを IInkAnalyzer に 追加し、アクティブな入力スレッドのカルチャ識別子をストロークに割り当てます。
AddStrokeForLanguage 1 つのストロークのストローク データを IInkAnalyzer に 追加し、特定のカルチャ識別子をストロークに割り当てます。
AddStrokes 複数のストロークのストローク データを IInkAnalyzer に 追加し、アクティブな入力スレッドのカルチャ識別子をストロークに割り当てます。
AddStrokesForLanguage 複数のストロークのストローク データを IInkAnalyzer に 追加し、指定したカルチャ識別子をストロークに割り当てます。
AddStrokesToCustomRecognizer 複数のストロークのストローク データをカスタム認識エンジン ノードに追加します。
AddStrokeToCustomRecognizer 1 つのストロークのストローク データをカスタム認識エンジン ノードに追加します。
分析 同期インク分析を実行します。
BackgroundAnalyze 非同期インク分析を実行します。
ClearStrokeData IInkAnalyzer からストローク パケット データをクリアします。
CreateAnalysisHint 無限領域を持つ新しい分析ヒント ノードを IInkAnalyzer に追加します。
CreateContextNodes IContextNodes オブジェクトを作成します。
CreateCustomRecognizer IInkAnalyzer の新しいカスタム認識エンジン ノードを作成します。
DeleteAnalysisHint IInkAnalyzer から分析ヒントを削除します。
FindInkLeafNodes すべてのインク リーフ ノードを取得します。
FindInkLeafNodesForStrokes 指定したストロークを含むインク リーフ ノードを取得します。
FindLeafNodes すべてのリーフ ノードを取得します。
FindNode 指定したグローバル一意識別子 (GUID) の IContextNode オブジェクトを取得します。
FindNodesOfType 指定した型のすべての IContextNode オブジェクトを取得します。
FindNodesOfTypeForStrokes 指定したストロークを含む、指定した型のすべての IContextNode オブジェクトを取得します。
FindNodesOfTypeInSubTree 指定した IContextNode オブジェクトの子孫である、指定した型のすべての IContextNode オブジェクトを取得します。
FindNodesWithCallBack 指定した条件に一致するすべての IContextNode オブジェクトを取得します。
FindNodesWithCallBackInSubTree 指定した条件に一致し、指定した IContextNode オブジェクトの子孫である IContextNode オブジェクトをすべて取得します。
GetAlternates IInkAnalyzer に関連付けられているすべてのインクの 10 個の分析代替候補を取得します。
GetAlternatesForContextNodes 指定した IContextNodes コレクション内のノードの分析代替を取得します。
GetAlternatesForStrokes 指定したストローク識別子を持つストロークの代替分析を取得します。
GetAnalysisHints IInkAnalyzer にアタッチされているすべての分析ヒント IContextNode オブジェクトを取得します。
GetAnalysisHintsByName IInkAnalyzer にアタッチされ、指定した名前を持つすべての分析ヒント IContextNode オブジェクトを取得します。
GetAnalysisModes IInkAnalyzer がインク分析を実行する方法を制御するフラグを取得します。
GetDirtyRegion 前回の分析操作以降に変更された領域を取得します。
GetInkAnalysisRecognizersByPriority IInkAnalysisRecognizer オブジェクトの順序付けられたコレクションを取得します。
GetNodesFromTextRange 指定したコンテキスト ノードの指定したテキスト範囲に関連する IContextNode オブジェクトのコレクションを取得します。
GetRecognizedString IInkAnalyzer 内のコンテキスト ノード ツリー全体の認識操作の最良の結果文字列を取得します。
GetRootNode IInkAnalyzer オブジェクトのコンテキスト ツリーのルート IContextNode を取得します。
GetStrokeLanguageId 指定したストロークのロケール識別子を取得します。
GetStrokeType 指定したストロークの型を取得します。
GetTextRangeFromNodes IContextNode オブジェクトのコレクションに対応する認識された文字列内のテキスト範囲を検索します。
IsAnalyzing IInkAnalyzer がインク分析を実行しているかどうかを示す値を取得します。
LoadResults 保存した分析結果を IInkAnalyzer に読み込みます。
ModifyTopAlternate 現在の先頭の代替を指定した代替に変更し、代替に関連付けられているすべての IContextNode オブジェクトの確認の種類をクリアします。
ModifyTopAlternateWithConfirmation 現在の先頭の代替を、指定された IAnalysisAlternate に変更します。
Reconcile バックグラウンド インク分析中に解析結果のどの部分が変更されたかを決定します。
RemoveStroke 指定したストロークを IInkAnalyzer から削除します。
RemoveStrokes 指定したストロークを IInkAnalyzer から削除します。
SaveResults IInkAnalyzer のすべての分析結果を保存します。
SaveResultsForNodes IInkAnalyzer に関連付けられている特定のコンテキスト ノード コレクションの分析結果を保存します。
SaveResultsForStrokes IInkAnalyzer に関連付けられている指定したストロークの分析結果を保存します。
Search 解析された書き込みストロークと、認識された型を持つ分析された描画ストロークに対して、あいまいで大文字と小文字を区別しない語句ベースの検索を提供します。
SearchWithLanguageId 解析された書き込みストロークと、認識された型を持つ分析された描画ストロークに対して、あいまいで大文字と小文字を区別しない語句ベースの検索を提供します。
SetAnalysisModes IInkAnalyzer がインク分析を実行する方法を制御するフラグを変更します。
SetDirtyRegion 前回の分析操作以降に変更された領域を変更します。
SetHighestPriorityInkAnalysisRecognizer 指定した IInkAnalysisRecognizer を 、IInkAnalyzer オブジェクトのインク認識エンジンの一覧の最初の位置に移動します。
SetStrokeLanguageId 指定したストロークのロケール識別子を変更します。
SetStrokesLanguageId 指定したストロークのロケール識別子を変更します。
SetStrokesType 指定したストロークの種類を変更します。
SetStrokeType 指定したストロークの種類を変更します。
UpdateStrokesData 指定したストロークのパケット データを更新します。

解説

IInkAnalyzer は、ストローク パケット データを使用してインクを分析し、 InkDisp クラス または InkStrokes コレクション オブジェクトと直接対話しません。

分析のために IInkAnalyzer に ストロークを追加または削除するには、次のいずれかの方法を使用します。

これらのメソッドは、次の分析操作でストロークが分析される領域であるダーティ領域 (IInkAnalyzer::GetDirtyRegion メソッドを参照) を更新します。

インクを分析するには、 IInkAnalyzer::Analyze メソッド または IInkAnalyzer::BackgroundAnalyze メソッドを 使用します。 分析中、 IInkAnalyzer はレイアウト分析、ストローク分類、手書き認識を実行します。

レイアウト分析とストローク分類の設定を変更するには、 IInkAnalyzer::SetAnalysisModes メソッド プロパティを 使用します。

分析中、 IInkAnalyzer はバックグラウンド分析中に生成されたイベントを含む多数のイベントを受け取ります。 _IAnalysisProxyEvents では、 IInkAnalyzer のデータ プロキシ機能がサポートされています。 詳細については、「 インク分析を使用したデータ プロキシ」を参照してください。 イベント ハンドラー内から分析プロセスを停止するには、 IInkAnalyzer::Abort メソッドを呼び出します。

インク アナライザーが手書きを認識するために使用する言語を変更するには、 IInkAnalyzer::SetStrokeLanguageId メソッド または IInkAnalyzer::SetStrokesLanguageId メソッドを使用します。 インク アナライザーが特定のストロークを分類する方法を変更するには、 IInkAnalyzer::SetStrokeType メソッド または IInkAnalyzer::SetStrokesType メソッドを使用します。

IInkAnalyzer は、インストールされているすべてのインク認識エンジンの情報を読み込みます。 IInkAnalyzer::GetInkAnalysisRecognizersByPriority メソッドは、使用可能な各 IInkAnalysisRecognizer を含む IInkAnalysisRecognizers コレクションを返します。 複数のインク認識エンジンが特定の言語をサポートしている場合は、 IInkAnalyzer::SetHighestPriorityInkAnalysisRecognizer メソッド を使用して、その言語のストロークを処理するインク認識エンジンを設定します。

分析ヒントを使用すると、インク アナライザーに追加のコンテキストを提供することで、認識の精度を向上させることができます。 追加のコンテキスト情報は、インク アナライザーで認識可能な結果の数を制限するのに役立ちます。 たとえば、ファクトロイドと予想される単語を定義したり、入力を認識ガイドに構成したりして、スコープを絞り込むことができます。 インク アナライザーにコンテキストを提供する方法の詳細については、次を参照してください。

インク アナライザーは、分析結果を文字列または IContextNode オブジェクトのツリーとして表します。 認識された文字列にアクセスするには、 IInkAnalyzer::GetRecognizedString メソッドを使用します。 コンテキスト ノード ツリーのルートにアクセスするには、 IInkAnalyzer::GetRootNode メソッドを使用します。 インク アナライザーには、特定のコンテキスト ノードまたはテキストを検索するための次のメソッドがあります。

別の分析結果を操作するには、次のいずれかの方法を使用します。

分析結果を保存するには、次のいずれかの方法を使用します。

保存された結果を読み込むには、 IInkAnalyzer::LoadResults メソッドを使用します。

IInkAnalyzer を使用してインクを分析する方法の詳細については、「インク分析の概要」を参照してください。

必要条件

要件 値
サポートされている最小のクライアント
 Windows XP Tablet PC Edition [デスクトップ アプリのみ]
サポートされている最小のサーバー
 サポートなし
Header
IACom.h (IACom_i.c も必要)
[DLL]
IACom.dll

関連項目

AnalysisModes

IAnalysisAlternate

IAnalysisStatus

IContextLink

IContextNode

インク分析リファレンス