Метод 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 [только классические приложения] |
Минимальная версия сервера |
Ни одна версия не поддерживается |
Заголовок |
|
DLL |
|