IDWriteFontFallback::MapCharacters 메서드(dwrite_2.h)

텍스트의 시작 범위를 렌더링하는 데 사용할 적절한 글꼴을 결정합니다.

구문

HRESULT MapCharacters(
                 IDWriteTextAnalysisSource *analysisSource,
                 UINT32                    textPosition,
                 UINT32                    textLength,
  [in, optional] IDWriteFontCollection     *baseFontCollection,
  [in, optional] wchar_t const             *baseFamilyName,
                 DWRITE_FONT_WEIGHT        baseWeight,
                 DWRITE_FONT_STYLE         baseStyle,
                 DWRITE_FONT_STRETCH       baseStretch,
  [out]          UINT32                    *mappedLength,
  [out]          IDWriteFont               **mappedFont,
  [out]          FLOAT                     *scale
);

매개 변수

analysisSource

형식: IDWriteTextAnalysisSource*

텍스트 원본 구현에는 텍스트 및 로캘이 포함됩니다.

textPosition

형식: UINT32

분석할 시작 위치입니다.

textLength

형식: UINT32

분석할 텍스트의 길이입니다.

[in, optional] baseFontCollection

형식: IDWriteFontCollection*

사용할 기본 글꼴 컬렉션입니다.

[in, optional] baseFamilyName

형식: const wchar_t*

기본 글꼴의 패밀리 이름입니다. null을 전달하면 가족에 대한 일치가 수행되지 않습니다.

baseWeight

형식: DWRITE_FONT_WEIGHT

원하는 가중치입니다.

baseStyle

형식: DWRITE_FONT_STYLE

원하는 스타일입니다.

baseStretch

형식: DWRITE_FONT_STRETCH

원하는 스트레치입니다.

[out] mappedLength

형식: UINT32*

매핑된 글꼴에 매핑된 텍스트의 길이입니다. 이는 항상 텍스트 길이보다 작거나 같으며 0보다 크므로(텍스트 길이가 0이 아닌 경우) 호출자가 하나 이상의 문자를 진행합니다.

[out] mappedFont

형식: IDWriteFont**

텍스트의 첫 번째 mappedLength 문자를 렌더링하는 데 사용해야 하는 글꼴입니다. NULL을 반환하면 글꼴이 텍스트를 렌더링할 수 없으며 mappedLength 는 건너뛸 문자 수(누락된 문자 모양으로 렌더링됨)입니다.

[out] scale

형식: FLOAT*

배율 인수를 사용하여 반환된 글꼴의 em 크기를 곱합니다.

반환 값

형식: HRESULT

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8.1 [데스크톱 앱만 해당]
지원되는 최소 서버	R2 Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	dwrite_2.h
라이브러리	Dwrite.lib
DLL	Dwrite.dll

추가 정보

IDWriteFontFallback