IDWriteTextAnalyzer1::GetTextComplexity 메서드(dwrite_1.h)

텍스트의 복잡성과 전체 스크립트 셰이핑을 위해 IDWriteTextAnalyzer::GetGlyphs 를 호출해야 하는지 여부를 결정합니다.

구문

HRESULT GetTextComplexity(
  [in]            WCHAR const     *textString,
                  UINT32          textLength,
                  IDWriteFontFace *fontFace,
  [out]           BOOL            *isTextSimple,
  [out]           UINT32          *textLengthRead,
  [out, optional] UINT16          *glyphIndices
);

매개 변수

[in] textString

형식: const WCHAR*

복잡성을 위해 검사 텍스트입니다. 이 문자열은 UTF-16일 수 있지만 보조 문자는 복잡한 것으로 간주됩니다.

textLength

형식: UINT32

검사 텍스트의 길이입니다.

fontFace

형식: IDWriteFontFace*

읽을 글꼴 얼굴입니다.

[out] isTextSimple

형식: BOOL*

true이면 텍스트가 단순하고 glyphIndices 배열에 명목 문자 모양이 이미 있습니다. 그렇지 않으면 IDWriteTextAnalyzer::GetGlyphs 를 호출하여 복잡한 스크립트 및 OpenType 기능을 올바르게 구성해야 합니다.

[out] textLengthRead

형식: UINT32*

텍스트 읽기 길이는 복잡성이 동일하거나 단순하거나 복잡하여 실행됩니다. 해당 시점부터 다시 호출할 수 있습니다.

[out, optional] glyphIndices

형식: UINT16*

텍스트에 대한 선택적 문자 모양 인덱스입니다. 함수가 텍스트가 단순하다는 것을 반환한 경우 필요한 문자 모양이 이미 있습니다. 그렇지 않으면 문자 모양 인덱스는 의미가 없으며 셰이핑을 위해 IDWriteTextAnalyzer::GetGlyphs 를 호출해야 합니다.

반환 값

형식: HRESULT

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

설명

문자가 복잡한 셰이핑 요구 사항이 있는 스크립트의 일부이거나, 양방향 분석이 필요하거나, 다른 문자와 결합하거나, 보조 평면에 상주하거나, 표준 OpenType 기능에 참여하는 문자 모양이 있는 경우 텍스트는 간단하지 않습니다. 반환되는 길이는 기본 문자의 결합 기호를 분할하지 않습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7용 Windows 8 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2용 Windows Server 2012 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	dwrite_1.h
라이브러리	Dwrite.lib
DLL	Dwrite.dll

추가 정보

IDWriteTextAnalyzer1

IDWriteTextAnalyzer::GetGlyphs