IInkAnalyzer::BackgroundAnalyze 메서드

  • 아티클

비동기 잉크 분석을 수행합니다.

구문

HRESULT BackgroundAnalyze();

매개 변수

이 메서드에는 매개 변수가 없습니다.

반환 값

반환 값에 대한 설명은 클래스 및 인터페이스 - 잉크 분석을 참조하세요.

설명

이 메서드가 호출되면 IInkAnalyzer 는 백그라운드 스레드에서 잉크 분석을 수행합니다.

이 메서드는 S_FALSE 반환하고 다음과 같은 상황에서 새 백그라운드 분석 작업을 시작하지 않습니다.

IInkAnalyzer는 IInkAnalyzer::Analyze 메서드 또는 IInkAnalyzer::BackgroundAnalyze 메서드를 호출하는 동안 더티 영역 내의 잉크를 분석합니다. 그러나 IInkAnalyzer 는 인접 지역을 포함하도록 분석 작업을 확장할 수 있습니다.

이 메서드는 더티 지역을 빈 지역으로 설정합니다.

IInkAnalyzer::BackgroundAnalyze 메서드 호출 후 스트로크 데이터가 IInkAnalyzer에 추가된 경우 IInkAnalyzer는 잉크 분석의 조정 단계에서 더티 영역을 업데이트할 수 있습니다.

분석 모드 설정( IInkAnalyzer::GetAnalysisModes 메서드 참조)은 IInkAnalyzer 가 백그라운드 분석을 수행하는 방법을 지정합니다. 잉크 분석에 대한 자세한 내용은 잉크 분석 개요를 참조하세요.

이 메서드는 다음과 같은 상황에서 오류 코드를 반환합니다.

예제

다음 예제에서는 잉크 분석기 더티 영역을 확인한 다음 더티 영역이 비어 있지 않으면 백그라운드 잉크 분석을 시작합니다.

// 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 태블릿 PC 버전 [데스크톱 앱만 해당]
지원되는 최소 서버
 지원되는 버전 없음
헤더
IACom.h(IACom_i.c 필요)
DLL
IACom.dll

추가 정보

IInkAnalyzer

AnalysisModes

IInkAnalyzer::Analyze 메서드

IInkAnalyzer::GetAnalysisModes 메서드

IInkAnalyzer::SetAnalysisModes 메서드

IInkAnalyzer::GetDirtyRegion 메서드

IInkAnalyzer::SetDirtyRegion 메서드

IInkAnalyzer::GetRootNode 메서드

잉크 분석 참조