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 버전 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
지원되는 버전 없음 |
| 헤더 |
|
| DLL |
|