IInkAnalyzer::LoadResults メソッド
保存した分析結果を IInkAnalyzer に読み込みます。
構文
HRESULT LoadResults(
[in] ULONG ulDataSize,
[in] BYTE *pbSerializedResults,
[in] ULONG ulStrokeIdsCount,
[in] LONG *plOriginalStrokeIds,
[in] LONG *plNewStrokeIds,
[out, retval] VARIANT_BOOL *pfSuccessful
);
パラメーター
-
ulDataSize [in]
-
pbSerializedResults のバイト数。
-
pbSerializedResults [in]
-
シリアル化された分析結果。
-
ulStrokeIdsCount [in]
-
ストローク識別子の数。
-
plOriginalStrokeIds [in]
-
元のストローク識別子の配列。
-
plNewStrokeIds [in]
-
新しいストローク識別子の配列。
-
pfSuccessful [out, retval]
-
読 み込みが成功した場合にVARIANT_TRUEします。それ以外の場合 は、VARIANT_FALSE。
戻り値
戻り値の説明については、「 クラスとインターフェイス - インク分析」を参照してください。
解説
IInkAnalyzer は、保存された結果から IContextNode を追加すると、新しいグローバル一意識別子 (GUID) を IContextNode に割り当てます (「IContextNode::GetPropertyData」および「コンテキスト ノードのプロパティ」を参照)。
このメソッドは、保存された分析結果を既存の IContextNode ツリーに追加します。 結合された結果が正しく順序付けられるようにするには、読み込まれたコンテキスト ノードを含む領域を IInkAnalyzer オブジェクトのダーティ領域に追加し (「IInkAnalyzer::GetDirtyRegion メソッド」を参照) し、インクを再分析します。
IInkAnalyzer::SaveResults メソッド、IInkAnalyzer::SaveResultsForNodes メソッド、および IInkAnalyzer::SaveResultsForStrokes メソッドの各メソッドは、パケット データを分析結果と共に保存しません。
plOriginalStrokeIds の各識別子は、保存された分析結果のストロークのストローク識別子です。 plNewStrokeIds の各識別子は、読み込まれた分析結果の元の識別子を置き換える新しい識別子です。
保存された分析ヒントが既存の分析ヒントと競合する場合、 IInkAnalyzer は保存されたヒントを読み込まず、保存された結果の残りの部分を読み込みます。 ただし、IInkAnalyzer によって、IInkAnalyzer が読み込まれない保存された分析ヒントの領域内にあるストロークの結果が読み込まれる場合、IInkAnalyzer はストロークの境界ボックスを IInkAnalyzer オブジェクトのダーティ領域に追加します。 また、IInkAnalyzer が既存の分析ヒントの領域内にあるストロークの結果を読み込む場合、IInkAnalyzer は、ストロークの境界ボックスも IInkAnalyzer オブジェクトのダーティ領域に追加します。 分析ヒントの詳細については、「 分析ヒントのプロパティ」を参照してください。
このメソッドは、保存された結果を読み込むにつれて、 _IAnalysisProxyEvents::ContextNodeCreated、 _IAnalysisProxyEvents::ContextNodeLinkAdding、 および _IAnalysisProxyEvents::ContextNodePropertiesUpdated イベントを発生させる可能性があります。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows XP Tablet PC Edition [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
サポートなし |
| Header |
|
| [DLL] |
|