Метод IInkAnalyzer::BackgroundAnalyze

Статья
06/13/2023

Выполняет асинхронный анализ рукописного ввода.

Синтаксис

HRESULT BackgroundAnalyze();

Параметры

Этот метод не имеет параметров.

Возвращаемое значение

Описание возвращаемых значений см. в разделе Классы и интерфейсы — анализ рукописного ввода.

IInkAnalyzer анализирует рукописный ввод в своей грязное области во время вызова метода IInkAnalyzer::Analyze или IInkAnalyzer::BackgroundAnalyze Method. Однако IInkAnalyzer может расширить операцию анализа, включив в нее соседние регионы.

Этот метод задает пустой регион грязное.

Если данные росчерка были добавлены в IInkAnalyzer после вызова метода IInkAnalyzer::BackgroundAnalyze, IInkAnalyzer может обновить грязное регион на этапе согласования анализа рукописного ввода.

Параметр режимов анализа (см. раздел Метод IInkAnalyzer::GetAnalysisModes) указывает, как IInkAnalyzer выполняет фоновый анализ. Дополнительные сведения об анализе рукописного ввода см. в статье Общие сведения об анализе рукописного ввода.

Этот метод возвращает код ошибки в следующих случаях.

Приложение задало значение AnalysisModesAnalysisModes_IntermediateResults в IInkAnalyzer (см. раздел Метод IInkAnalyzer::SetAnalysisModes) и не обрабатывает событие _IAnalysisEvents::IntermediateResults .
Приложение очистило значение AnalysisModesAnalysisModes_AutomaticReconciliation в IInkAnalyzer (см. раздел Метод IInkAnalyzer::SetAnalysisModes) и не обрабатывает событие _IAnalysisEvents::ReadyToReconcile .
Приложение не обрабатывает событие _IAnalysisEvents::Results .
Приложение не обрабатывает событие _IAnalysisEvents::UpdateStrokesCache .

Примеры

В следующем примере проверяется область грязное анализатора рукописного ввода, а затем инициируется фоновый анализ рукописного ввода, если область грязное не пуста.

// Check that the ink analyzer's dirty region is not empty.
IAnalysisRegion *pDirtyRegion;
hr = this->m_spIInkAnalyzer->GetDirtyRegion(&pDirtyRegion);

if (SUCCEEDED(hr))
{
    VARIANT_BOOL bIsEmpty;
    hr = pDirtyRegion->IsEmpty(&bIsEmpty);

    if (SUCCEEDED(hr))
    {
        if (!bIsEmpty)
        {
            // Insert code that prepares the application for background
            // ink analysis here.

            // Start background ink analysis. The _IAnalysisEvents::Results
            // event signals when background ink analysis is complete.
            hr = this->m_spIInkAnalyzer->BackgroundAnalyze();
        }
    }
}

// Free the memory for the dirty region.
if (pDirtyRegion != NULL)
{
    pDirtyRegion->Release();
}

Требования

Требование	Значение
Минимальная версия клиента	Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Заголовок	IACom.h (также требуется IACom_i.c)
DLL	IACom.dll

См. также раздел

IInkAnalyzer
AnalysisModes
Метод IInkAnalyzer::Analyze
Метод IInkAnalyzer::GetAnalysisModes
Метод IInkAnalyzer::SetAnalysisModes
Метод IInkAnalyzer::GetDirtyRegion
Метод IInkAnalyzer::SetDirtyRegion
Метод IInkAnalyzer::GetRootNode
Справочник по анализу рукописного ввода

Поделиться через