IInkAnalyzer::GetRecognizedString メソッド

IInkAnalyzer 内のコンテキスト ノード ツリー全体の認識操作の最良の結果文字列を取得します。

構文

HRESULT GetRecognizedString(
  [out] BSTR *pbstrRecognizedString
);

パラメーター

pbstrRecognizedString [out]

IInkAnalyzer のコンテキスト ノード ツリー全体に対する認識操作の最良の結果文字列。

戻り値

戻り値の説明については、「 クラスとインターフェイス - インク分析」を参照してください。

解説

注意事項

メモリ リークを回避するには、文字列を使用する必要がなくなったときに、pbstrRecognizedString の SysFreeString を呼び出します。

このメソッドは、認識された文字列のルート ノードのプロパティ データと同じ値を返します。 ( 「IInkAnalyzer::GetRootNode メソッド」、「 IContextNode::GetPropertyData」、および 「コンテキスト ノードのプロパティ」を参照してください)。

例

次の例は、インク アナライザーの IContextNode 結果ツリーをウォークするメソッドを示しています。 IInkAnlyzer が現在インク分析を実行していない場合、メソッドは次の処理を行います。

• 最上位の認識文字列を取得します。
• インク アナライザーのルート ノードを取得します。
• ヘルパー メソッド を呼び出して、 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

インク分析リファレンス