IInkAnalyzer::BackgroundAnalyze 메서드
비동기 잉크 분석을 수행합니다.
구문
HRESULT BackgroundAnalyze();
매개 변수
이 메서드에는 매개 변수가 없습니다.
반환 값
반환 값에 대한 설명은 클래스 및 인터페이스 - 잉크 분석을 참조하세요.
설명
이 메서드가 호출되면 IInkAnalyzer 는 백그라운드 스레드에서 잉크 분석을 수행합니다.
이 메서드는 S_FALSE 반환하고 다음과 같은 상황에서 새 백그라운드 분석 작업을 시작하지 않습니다.
- IInkAnalyzer는 현재 백그라운드 분석을 수행하고 있습니다.
- 더티 지역(IInkAnalyzer::GetDirtyRegion 메서드 참조)은 빈 영역을 나타냅니다.
IInkAnalyzer는 IInkAnalyzer::Analyze 메서드 또는 IInkAnalyzer::BackgroundAnalyze 메서드를 호출하는 동안 더티 영역 내의 잉크를 분석합니다. 그러나 IInkAnalyzer 는 인접 지역을 포함하도록 분석 작업을 확장할 수 있습니다.
이 메서드는 더티 지역을 빈 지역으로 설정합니다.
IInkAnalyzer::BackgroundAnalyze 메서드 호출 후 스트로크 데이터가 IInkAnalyzer에 추가된 경우 IInkAnalyzer는 잉크 분석의 조정 단계에서 더티 영역을 업데이트할 수 있습니다.
분석 모드 설정( IInkAnalyzer::GetAnalysisModes 메서드 참조)은 IInkAnalyzer 가 백그라운드 분석을 수행하는 방법을 지정합니다. 잉크 분석에 대한 자세한 내용은 잉크 분석 개요를 참조하세요.
이 메서드는 다음과 같은 상황에서 오류 코드를 반환합니다.
- 애플리케이션이 IInkAnalyzer에서 AnalysisModes 값을 AnalysisModes_IntermediateResults 설정했으며(IInkAnalyzer::SetAnalysisModes 메서드 참조) _IAnalysisEvents::IntermediateResults 이벤트를 처리하지 않습니다.
- 애플리케이션이 IInkAnalyzer에서 AnalysisModes_AutomaticReconciliationAnalysisModes 값을 지우고(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 태블릿 PC 버전 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
지원되는 버전 없음 |
| 헤더 |
|
| DLL |
|