IInkAnalyzer::CreateAnalysisHint メソッド
IInkAnalyzer に、無限領域を持つ新しい分析ヒント ノードを追加します。
構文
HRESULT CreateAnalysisHint(
[out] IContextNode **ppAnalysisHint
);
パラメーター
-
ppAnalysisHint [out]
-
新しい分析ヒント ノード。
戻り値
戻り値の説明については、「 クラスとインターフェイス - インク分析 」を参照してください。
解説
注意事項
メモリ リークを回避するには、 オブジェクトを使用する必要がなくなったときに、ppAnalysisHint で IUnknown::Release を呼び出します。
IInkAnalyzer の追加のコンテキスト情報を提供するには、インク アナライザーに分析ヒントを追加します。 分析ヒントを使用すると、認識精度を向上させることができます。 たとえば、フォーム アプリケーションのフィールドに factoid とガイド情報を追加できます。
このメソッドは、AnalysisHint のコンテキスト ノード の種類を持つ新しい IContextNode を作成し ( 「IContextNode::GetType」を参照)、新しいヒントを IInkAnalyzer オブジェクトのルート ノードのサブノードとして追加します ( 「IContextNode::GetSubNodes 」および「 IInkAnalyzer::GetRootNode メソッド」を参照してください)。
ヒントにコンテキスト情報を追加するには、pPropertyDataId パラメーターを Analysis Hint Properties 定数のいずれかに設定して IContextNode::AddPropertyData を使用します。
ヒントにグローバル ヒントと呼ばれる無限領域が割り当てられている場合、 IInkAnalyzer は、別のヒントの領域内にないすべてのインクにヒントのコンテキストを適用します。 複数のヒントを 1 つの IInkAnalyzer にアタッチできます。 ただし、1 つのインク アナライザーにアタッチできるグローバル ヒントは 1 つだけであり、グローバル以外のヒントは重複できません。 ヒントで提供できるコンテキスト情報の種類の詳細については、「 分析ヒントのプロパティ」を参照してください。
分析ヒントを追加しても、再分析のヒントの領域はマークされません。 再分析のヒント内の領域をマークするには、IInkAnalyzer::SetDirtyRegion メソッドを使用して、ダーティ領域を分析ヒントの現在のダーティ領域と領域の和集合に設定します。
フォーム アプリケーションにヒントを使用する場合、アプリケーションでは、テキスト コンテキストとフォーム内のインクの混在を回避する必要があります。 これは、たとえば、テキスト フィールド名を分析ツリーに作成しないことを意味します。 ヒントは、ページ上の領域にインクを関連付けるために用意されています。テキスト コンテキストは、このインクからヒントへの関連付けに干渉します。 分析操作では、インクとテキスト コンテキストが同じ書き込み領域にマージされ、インクがヒント領域に関連付けられるのを防ぐことができます。
インク分析の詳細については、「インク分析の 概要」を参照してください。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows XP タブレット PC エディション [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
サポートなし |
| Header |
|
| [DLL] |
|