IInkAnalyzer::GetRootNode 메서드

IInkAnalyzer 개체의 컨텍스트 트리의 루트 IContextNode를 가져옵니다.

구문

HRESULT GetRootNode(
  [out] IContextNode **ppRootNode
);

매개 변수

ppRootNode [out]

IInkAnalyzer 개체의 컨텍스트 트리의 루트 IContextNode입니다.

반환 값

반환 값에 대한 설명은 클래스 및 인터페이스 - 잉크 분석을 참조하세요.

설명

주의

메모리 누수 방지를 위해 더 이상 루트 노드를 사용할 필요가 없는 경우 ppRootNode에서 IUnknown::Release를 호출합니다.

IInkAnalyzer는 IContextNode 개체의 트리를 유지 관리합니다. 이러한 개체에는 분석을 위한 입력과 분석 결과가 모두 포함됩니다. 스트로크가 처음에 IInkAnalyzer에 추가되면 IInkAnalyzer 는 UnclassifiedInk 형식의 IContextNode 에 할당합니다( IContextNode::GetType 및 컨텍스트 노드 형식 참조). 스트로크를 분석한 후 IInkAnalyzer 는 트리의 적절한 IContextNode 개체에 할당합니다. IInkAnalyzer를 사용하여 잉크를 분석하는 방법에 대한 자세한 내용은 잉크 분석 개요를 참조하세요.

예제

다음 예제에서는 잉크 분석기 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 태블릿 PC 버전 [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
헤더	IACom.h(IACom_i.c도 필요)
DLL	IACom.dll

추가 정보

IInkAnalyzer

IContextNode

컨텍스트 노드 형식

잉크 분석 참조