Metodo IInkAnalyzer::GetRecognizedString

Recupera la stringa di risultato migliore dell'operazione di riconoscimento per l'intero albero del nodo di contesto in IInkAnalyzer.

Sintassi

HRESULT GetRecognizedString(
  [out] BSTR *pbstrRecognizedString
);

Parametri

pbstrRecognizedString [out ]

Stringa di risultato ottimale dell'operazione di riconoscimento per l'intero albero del nodo di contesto in IInkAnalyzer.

Valore restituito

Per una descrizione dei valori restituiti, vedere Classi e interfacce - Analisi input penna.

Commenti

Attenzione

Per evitare una perdita di memoria, chiamare SysFreeString per pbstrRecognizedString quando non è più necessario usare la stringa.

Questo metodo restituisce lo stesso valore dei dati della proprietà del nodo radice per la stringa riconosciuta. Vedere Il metodo IInkAnalyzer::GetRootNode, IContextNode::GetPropertyData e le proprietà del nodo contesto.

Esempio

Nell'esempio seguente viene illustrato un metodo che illustra l'albero dei risultati IContextNode dell'analizzatore input penna. Se IInkAnlyzer non esegue attualmente l'analisi dell'input penna, il metodo esegue le operazioni seguenti.

• Ottiene la stringa di riconoscimento superiore.
• Ottiene il nodo radice dell'analizzatore input penna.
• Chiama un metodo helper, , ExploreContextNodeper esaminare il nodo radice e i relativi nodi figlio.

// 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;
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Intestazione	IACom.h (richiede anche IACom_i.c)
DLL	IACom.dll

Vedi anche

IInkAnalyzer

Informazioni di riferimento per l'analisi dell'input penna