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 時,它會將新的全域唯一識別碼指派給ICoNtextNode) (GUID (請參閱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 [僅限傳統型應用程式] |
最低支援的伺服器 |
都不支援 |
標頭 |
|
DLL |
|