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值AnalysisModes_AutomaticReconciliation, (請參閱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 [僅限傳統型應用程式] |
最低支援的伺服器 |
都不支援 |
標頭 |
|
DLL |
|