IInkAnalyzer::IsAnalyzing 方法

擷取值,指出 IInkAnalyzer 是否正在執行筆跡分析。

語法

HRESULT IsAnalyzing(
  [out] VARIANT_BOOL *pbAnalyzing
);

參數

pbAnalyzing [out]

如果IInkAnalyzer 正在執行筆跡分析,VARIANT_TRUE;否則, VARIANT_FALSE

傳回值

如需傳回值的描述,請參閱 類別和介面 - 筆跡分析

備註

如果IInkAnalyzer正在執行同步或非同步分析則此屬性VARIANT_TRUE。

範例

下列範例顯示一個方法,會逐步執行筆跡分析器的 ICoNtextNode 結果樹狀結構。 如果筆跡分析器目前未執行筆跡分析,此方法會執行下列動作。

  • 取得頂端辨識字串。
  • 取得筆跡分析器的根節點。
  • 呼叫協助程式方法 ExploreContextNode ,以檢查根節點及其子節點。
// Helper method that explores the current analysis results of an ink analyzer.
HRESULT CMyClass::ExploreAnalysisResults(
    IInkAnalyzer *pInkAnalyzer)
{
    // Check that the ink analyzer is not currently analyzing ink.
    VARIANT_BOOL bIsAnalyzing;
    HRESULT hr = pInkAnalyzer->IsAnalyzing(&bIsAnalyzing);

    if (SUCCEEDED(hr))
    {
        if (bIsAnalyzing)
        {
            return E_PENDING;
        }

        // Get the ink analyzer's best-result string.
        BSTR recognizedString = NULL;
        hr = pInkAnalyzer->GetRecognizedString(&recognizedString);

        if (SUCCEEDED(hr))
        {
            // Insert code that records the ink analyzer's best-result string here.

            // Get the ink analyzer's root node.
            IContextNode *pRootNode = NULL;
            hr = pInkAnalyzer->GetRootNode(&pRootNode);

            if (SUCCEEDED(hr))
            {
                // Call a helper method that recursively explores context
                // nodes and their subnodes.
                hr = this->ExploreContextNode(pRootNode);
            }

            // Release this reference to the root node.
            if (pRootNode != NULL)
            {
                pRootNode->Release();
                pRootNode = NULL;
            }
        }

        // Free the system resources for the recognized string.
        SysFreeString(recognizedString);
    }

    return hr;
}

規格需求

需求
最低支援的用戶端
Windows XP Tablet PC Edition [僅限傳統型應用程式]
最低支援的伺服器
都不支援
標頭
IACom.h (也需要 IACom_i.c)
DLL
IACom.dll

另請參閱

IInkAnalyzer

IInkAnalyzer::Analyze 方法

IInkAnalyzer::BackgroundAnalyze 方法

筆跡分析參考