IDWriteFontFace1::GetUnicodeRanges 메서드(dwrite_1.h)

글꼴에서 지원하는 문자 범위 목록을 검색합니다.

구문

HRESULT GetUnicodeRanges(
                  UINT32               maxRangeCount,
  [out, optional] DWRITE_UNICODE_RANGE *unicodeRanges,
  [out]           UINT32               *actualRangeCount
);

매개 변수

maxRangeCount

형식: UINT32

클라이언트에서 전달된 최대 문자 범위 수입니다.

[out, optional] unicodeRanges

형식: DWRITE_UNICODE_RANGE*

문자 범위로 채워진 DWRITE_UNICODE_RANGE 구조체의 배열입니다.

[out] actualRangeCount

형식: UINT32*

최대 개수에 관계없이 실제 문자 범위 수에 대한 포인터입니다.

반환 값

형식: HRESULT

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

설명

글꼴에서 지원하는 문자 범위 목록은 문자 선택, 문자 모양 표시 및 효율적인 글꼴 선택 조회와 같은 시나리오에 유용합니다. 이는 16비트 UCS-2뿐만 아니라 전체 유니코드 범위를 반환한다는 점을 제외하고 GDI의 GetFontUnicodeRanges와 비슷합니다.

이러한 범위는 OS/2::ulCodePageRange1이 아닌 cmap에서 가져옵니다.

이 메서드를 사용할 수 없는 경우 IDWriteFontFace::GetGlyphIndices 메서드를 사용하여 누락된 문자 모양을 검사 수 있습니다. 메서드는 글꼴에 없는 문자 모양에 대 한 0 인덱스를 반환 합니다.

IDWriteFont::HasCharacter 메서드는 글꼴 대체와 같이 단일 문자 또는 일련의 단일 문자를 연속해서 검사 하는 경우에 더 간단합니다.

요구 사항

추가 정보

IDWriteFontFace1