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

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

반환 값	설명
S_OK	메서드가 성공적으로 실행되었습니다.
E_NOT_SUFFICIENT_BUFFER	버퍼가 너무 작습니다. actualRangeCount가 maxRangeCount 이상이었습니다.

설명

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

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

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

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

요구 사항

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

추가 정보

IDWriteFontFace1