IInkAnalyzer::LoadResults-Methode
Lädt gespeicherte Analyseergebnisse in den IInkAnalyzer.
Syntax
HRESULT LoadResults(
[in] ULONG ulDataSize,
[in] BYTE *pbSerializedResults,
[in] ULONG ulStrokeIdsCount,
[in] LONG *plOriginalStrokeIds,
[in] LONG *plNewStrokeIds,
[out, retval] VARIANT_BOOL *pfSuccessful
);
Parameter
-
ulDataSize [in]
-
Die Anzahl der Bytes in pbSerializedResults.
-
pbSerializedResults [in]
-
Die serialisierten Analyseergebnisse.
-
ulStrokeIdsCount [in]
-
Die Anzahl der Strichbezeichner.
-
plOriginalStrokeIds [in]
-
Das Array der ursprünglichen Strichbezeichner.
-
plNewStrokeIds [in]
-
Das Array der neuen Strichbezeichner.
-
pfSuccessful [out, retval]
-
VARIANT_TRUE , wenn das Laden erfolgreich war; andernfalls VARIANT_FALSE.
Rückgabewert
Eine Beschreibung der Rückgabewerte finden Sie unter Klassen und Schnittstellen – Freihandanalyse.
Bemerkungen
Wenn der IInkAnalyzer einen IContextNode aus den gespeicherten Ergebnissen hinzufügt, weist er dem IContextNode einen neuen global eindeutigen Bezeichner (GUID) zu (siehe IContextNode::GetPropertyData - und Kontextknoteneigenschaften).
Diese Methode fügt die gespeicherten Analyseergebnisse der vorhandenen IContextNode-Struktur hinzu. Um sicherzustellen, dass die kombinierten Ergebnisse ordnungsgemäß sortiert werden, fügen Sie den Bereich mit den geladenen Kontextknoten der modifiziert Region des IInkAnalyzer-Objekts hinzu (siehe IInkAnalyzer::GetDirtyRegion-Methode), und analysieren Sie die Freihand erneut.
Die Methoden IInkAnalyzer::SaveResults-Methode, IInkAnalyzer::SaveResultsForNodes-Methode und IInkAnalyzer::SaveResultsForStrokes-Methode speichern die Paketdaten nicht zusammen mit den Analyseergebnissen.
Jeder Bezeichner in plOriginalStrokeIds ist der Strichbezeichner für den Strich in den gespeicherten Analyseergebnissen. Jeder Bezeichner in plNewStrokeIds ist der neue Bezeichner, durch den der ursprüngliche Bezeichner in den geladenen Analyseergebnissen ersetzt werden soll.
Wenn ein gespeicherter Analysehinweis mit einem vorhandenen Analysehinweis in Konflikt steht, lädt der IInkAnalyzer nicht den gespeicherten Hinweis, sondern lädt den Rest der gespeicherten Ergebnisse. Wenn der IInkAnalyzer jedoch Ergebnisse für einen Strich lädt, der sich innerhalb des Bereichs eines gespeicherten Analysehinweiss befindet, den der IInkAnalyzer nicht lädt, fügt der IInkAnalyzer das Begrenzungsfeld des Strichs dem modifiziert Bereich des IInkAnalyzer-Objekts hinzu. Wenn der IInkAnalyzer ergebnisse für einen Strich lädt, der sich innerhalb des Bereichs eines vorhandenen Analysehinweiss befindet, fügt der IInkAnalyzer auch das begrenzungsfeld der Strich dem modifiziert Bereich des IInkAnalyzer-Objekts hinzu. Weitere Informationen zu Analysehinweisen finden Sie unter Eigenschaften von Analysehinweisen.
Diese Methode kann beim Laden der gespeicherten Ergebnisse die Ereignisse _IAnalysisProxyEvents::ContextNodeCreated, _IAnalysisProxyEvents::ContextNodeLinkAdding und _IAnalysisProxyEvents::ContextNodePropertiesUpdated auslösen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP Tablet PC Edition [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Nicht unterstützt |
| Header |
|
| DLL |
|