IContextNode::GetPropertyData 메서드

  • 아티클

지정된 식별자에 대한 애플리케이션별 데이터 또는 기타 속성 데이터를 검색합니다.

구문

HRESULT GetPropertyData(
  [in]      const GUID  *pPropertyDataId,
  [in, out]       ULONG *pulPropertyDataSize,
  [out]           BYTE  **ppbPropertyData
);

매개 변수

pPropertyDataId [in]

데이터의 식별자입니다.

pulPropertyDataSize [in, out]

데이터의 크기(바이트)입니다. 전달된 값은 사용되지 않습니다.

ppbPropertyData [out]

속성 데이터를 포함하는 8비트 부호 없는 정수 배열에 대한 포인터입니다.

반환 값

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

설명

주의

메모리 누수 방지를 위해 더 이상 정보가 필요하지 않은 경우 CoTaskMemFree 를 사용하여 *ppbPropertyData 에서 메모리를 해제합니다.

이 메서드는 IContextNode::AddPropertyData를 사용하여 추가된 애플리케이션별 데이터를 검색하는 것 외에도 컨텍스트 노드 속성 상수에서 설명하는 공통 속성을 검색하는 데 사용됩니다.

문자열 형식 속성은 다음과 같습니다.

  • GUID_CNP_RECOGNIZEDSTRING
  • GUID_CNP_SHAPENAME
  • GUID_AHP_ANALYSISHINTNAME
  • GUID_AHP_PREFIXTEXT
  • GUID_AHP_SUFFIXTEXT
  • GUID_AHP_FACTOID

반환 값은 WCHAR*입니다. *ppbPropertyData 매개 변수를 WCHAR* 로 캐스팅하면 반환된 길이는 입니다 (length of the string + 1) * sizeof(WCHAR).

부울 형식 속성은 다음과 같습니다.

  • GUID_AHP_OVERRIDELANGUAGEID
  • GUID_AHP_COERCETOFACTOID
  • GUID_AHP_WORDMODE

반환 값은 VARIANT_BOOL. *ppbPropertyData 매개 변수를 VARIANT_BOOL* 로 캐스팅하면 반환된 길이는 입니다 sizeof(VARIANT_BOOL).

GUID_AHP_GUIDE 가이드 형식 속성입니다. 반환 값은 InkAnalysisRecognitionGuide*입니다. *ppbPropertyData 매개 변수를 InkAnalysisRecognitionGuide* 로 캐스팅하는 경우 반환된 길이는 입니다 sizeof(InkAnalysisRecognitionGuide).

정수 형식 속성은 다음과 같습니다.

  • GUID_CNP_LINENUMBER
  • GUID_CNP_POINTSPERINCH
  • GUID_CNP_CONFIDENCELEVEL
  • GUID_CNP_CONFIRMATION
  • GUID_CNP_MAXIMUMSTROKECOUNT
  • GUID_CNP_SEGMENTATION
  • GUID_CNP_ALIGNMENTLEVEL

반환 값은 LONG*입니다. *ppbPropertyData 매개 변수를 LONG* 으로 캐스팅하면 반환된 길이는 입니다 sizeof(LONG).

줄 메트릭 형식 속성은 다음과 같습니다.

  • GUID_CNP_ASCENDERS
  • GUID_CNP_DESCENDERS
  • GUID_CNP_BASELINE
  • GUID_CNP_MIDLINE

반환 값은 LONG*입니다. *ppbPropertyData 매개 변수를 LONG* 으로 캐스팅하면 반환된 길이는 이고 sizeof(LONG)*4, 시작점의 값(x, y) 뒤에 끝점에 대한 값(x, y)을 나타냅니다.

GUID_CNP_TEXTRECOGNIZERID GUID 속성입니다. 반환 값은 GUID*입니다. *ppbPropertyData 매개 변수를 GUID* 로 캐스팅하면 반환된 길이는 입니다 sizeof(GUID).

GUID_CNP_ROTATEDBOUNDINGBOX 회전된 경계 상자 속성입니다. 반환 값은 LONG*입니다. *ppbPropertyData 매개 변수를 LONG* 으로 캐스팅하는 경우 반환된 길이는 상자의 네 모서리에 대한 (x, y) 값을 나타내는 입니다 sizeof(LONG)*8.

GUID_CNP_HOTPOINT 핫포인트 속성입니다. 반환 값은 LONG*입니다. *ppbPropertyData 매개 변수를 LONG* 으로 캐스팅하는 경우 반환된 길이는 이며 sizeof(LONG)*2, 이는 점의 (x, y) 값을 나타냅니다.

GUID_AHP_WORDLIST 단어 목록 속성입니다. 반환 값은 WCHAR*입니다. *ppbPropertyData 매개 변수를 WCHAR* 로 캐스팅하는 경우 반환된 길이는 입니다 n * sizeof(WCHAR). 여기서 n 는 목록의 문자열 수에 대한 문자열 길이의 합계와 각 문자열의 각 NULL 종료 문자에 대해 1을 더한 값입니다.

예제

이 예제에서는 Paragraph 컨텍스트 노드 형식의 AlignmentLevel 컨텍스트 노드 속성에 액세스하는 메서드를 보여줍니다.

// Checks a paragraph context node's alignment level property.
// Only paragraph type context nodes contain the alignment level property.
HRESULT CMyClass::ExploreParagraphNode(
    IContextNode *pParagraphNode)
{
    // Get the AlignmentLevel property data for the paragraph.
    LONG * alignmentLevel = NULL;
    ULONG ulDataLen = 0;

    HRESULT hr = pParagraphNode->GetPropertyData(
        (const GUID*)&GUID_CNP_ALIGNMENTLEVEL,
        &ulDataLen,
        (BYTE**)&alignmentLevel);

    if( FAILED(hr) ||
        ulDataLen != sizeof(LONG) ||
        alignmentLevel == NULL )
    {
        // Insert code that handles an error here.
    }
    else
    {
        // Insert code that uses the alignment level here.
    }

    // Free the memory allocated for the property data.
    ::CoTaskMemFree(alignmentLevel);

    return hr;
}

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당]
지원되는 최소 서버
 지원되는 버전 없음
헤더
IACom.h(IACom_i.c 필요)
DLL
IACom.dll

추가 정보

IContextNode

IContextNode::AddPropertyData

IContextNode::RemovePropertyData

IContextNode::GetPropertyDataIds

IContextNode::ContainsPropertyData

IContextNode::LoadPropertiesData

IContextNode::SavePropertiesData

잉크 분석 참조