IInkAnalyzer::IsAnalyzing-Methode

Ruft einen Wert ab, der angibt, ob der IInkAnalyzer eine Ink-Analyse vorgibt.

Syntax

HRESULT IsAnalyzing(
  [out] VARIANT_BOOL *pbAnalyzing
);

Parameter

pbAnalyzing [ out]

VARIANT _ TRUE, wenn der IInkAnalyzer eine Ink-Analyse durchfing; andernfalls VARIANT _ FALSE.

Rückgabewert

Eine Beschreibung der Rückgabewerte finden Sie unter Klassen und Schnittstellen – Ink-Analyse.

Hinweise

Diese Eigenschaft ist VARIANT _ TRUE, wenn der IInkAnalyzer synchrone oder asynchrone Analysen vorsteuert.

Beispiele

Das folgende Beispiel zeigt eine Methode, die die IContextNode-Ergebnisstruktur des Ink Analyzers durchfingt. Wenn die Ink-Analyse derzeit keine Ink-Analyse durchfing, führt die -Methode Folgendes aus.

  • Ruft die oberste Erkennungszeichenfolge ab.
  • Ruft den Stammknoten des Ink Analyzers ab.
  • Ruft die Hilfsmethode auf, ExploreContextNode um den Stammknoten und seine untergeordneten Knoten zu untersuchen.
// 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;
}

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur Desktop-Apps der XP Tablet PC Edition []
Unterstützte Mindestversion (Server)
Nicht unterstützt
Header
IACom.h (erfordert auch IACom _ i.c)
DLL
IACom.dll

Weitere Informationen

IInkAnalyzer

IInkAnalyzer::Analyze-Methode

IInkAnalyzer::BackgroundAnalyze-Methode

Referenz zur Ink-Analyse