Metode IInkAnalyzer::GetRecognizedString

Mengambil string hasil terbaik dari operasi pengenalan untuk seluruh pohon simpul konteks di IInkAnalyzer.

Sintaks

HRESULT GetRecognizedString(
  [out] BSTR *pbstrRecognizedString
);

Parameter

pbstrRecognizedString [out]

String hasil terbaik dari operasi pengenalan untuk seluruh pohon simpul konteks di IInkAnalyzer.

Menampilkan nilai

Untuk deskripsi nilai yang dikembalikan, lihat Kelas dan Antarmuka - Analisis Tinta.

Keterangan

Perhatian

Untuk menghindari kebocoran memori, panggil SysFreeString untuk pbstrRecognizedString saat Anda tidak perlu lagi menggunakan string.

Metode ini mengembalikan nilai yang sama dengan data properti simpul akar untuk string yang dikenali. (Lihat IInkAnalyzer::GetRootNode Method, IContextNode::GetPropertyData, dan Context Node Properties.)

Contoh

Contoh berikut menunjukkan metode yang memandu pohon hasil IContextNode penganalisis tinta. Jika IInkAnlyzer saat ini tidak melakukan analisis tinta, metode melakukan hal berikut.

• Mendapatkan string pengenalan teratas.
• Mendapatkan simpul akar penganalisis tinta.
• Memanggil metode pembantu, ExploreContextNode, untuk memeriksa simpul akar dan simpul anaknya.

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP Tablet PC Edition [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Header	IACom.h (juga memerlukan IACom_i.c)
DLL	IACom.dll

Lihat juga

IInkAnalyzer

Referensi Analisis Tinta