IDWriteTextAnalysisSource::GetTextAtPosition 메서드(dwrite.h)

지정된 텍스트 위치에서 시작하는 텍스트 블록을 가져옵니다.

구문

HRESULT GetTextAtPosition(
        UINT32      textPosition,
  [out] WCHAR const **textString,
  [out] UINT32      *textLength
);

매개 변수

textPosition

형식: UINT32

가져올 조각의 첫 번째 위치입니다. 모든 위치는 보조 문자를 사용할 때 중요한 전체 문자가 아닌 UTF16 코드 단위에 있습니다.

[out] textString

형식: const WCHAR**

이 메서드가 반환될 때 텍스트 분석에서 검색할 문자 배열로 텍스트 블록의 주소를 포함합니다.

[out] textLength

형식: UINT32*

이 메서드가 반환될 때 검색된 청크의 UTF16 단위 수를 포함합니다. 반환된 길이는 블록의 길이가 아니라 지정된 위치에서 끝까지 블록에 남아 있는 길이입니다. 예를 들어 위치가 75개인 위치를 100개 위치 블록으로 쿼리하면 25가 반환됩니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

NULL을 반환하면 마지막 문자 뒤에 오는 위치인 텍스트의 끝을 나타냅니다. 이 함수는 각 연속 블록에 대해 반복적으로 호출되며, 백업 저장소의 여러 조각화된 블록을 가상 연속 문자열에 연결합니다.

애플리케이션은 백업 저장소의 일부만 매핑하는 스파스 텍스트 콘텐츠를 구현할 수 있지만 애플리케이션은 분석 함수에 전달된 범위에 있는 텍스트를 매핑해야 합니다.

요구 사항

추가 정보

IDWriteTextAnalysisSource