IDWriteFontFace::GetGlyphIndices 메서드(dwrite.h)

글꼴 'CMAP' 테이블에 정의된 대로 UCS4 유니코드 코드 포인트의 명목 매핑을 문자 모양 인덱스에 반환합니다.

구문

HRESULT GetGlyphIndices(
  [in]  UINT32 const *codePoints,
        UINT32       codePointCount,
  [out] UINT16       *glyphIndices
);

매개 변수

[in] codePoints

형식: const UINT32*

명목 문자 모양 인덱스를 가져올 USC4 코드 지점의 배열입니다. 배열을 할당해야 하며 codePointCount에 지정된 요소 수를 포함할 수 있어야 합니다.

codePointCount

형식: UINT32

codePoints 배열의 요소 수입니다.

[out] glyphIndices

형식: UINT16*

이 메서드가 반환되면 이 함수로 채워진 명목 문자 모양 인덱스 배열에 대한 포인터를 포함합니다.

반환 값

형식: HRESULT

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

설명

이 매핑은 주로 실제 글꼴 API를 기반으로 빌드된 선 레이아웃 엔진에 제공됩니다. OpenType 문자 모양 대체 및 줄 레이아웃 문자 대체로 인해 명목 변환은 특정 글꼴 얼굴을 사용하여 렌더링할 때 유니코드 문자열이 문자 모양 인덱스에 매핑되는 방식에 항상 해당하지는 않습니다. 또한 유니코드 변형 선택기는 문자 문자 모양에 대한 대체 매핑을 제공합니다. 이 호출은 항상 기본 변형을 반환합니다.

글꼴에 문자가 없으면 이 메서드는 정의되지 않은 문자 모양 또는 ".notdef" 문자 모양인 인덱스 0을 반환합니다. 문자가 글꼴에 없는 경우 IDWriteFont::HasCharacter는 false를 반환하고 GetUnicodeRanges는 범위에서 반환하지 않습니다.

요구 사항

지원되는 최소 클라이언트	Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	dwrite.h
라이브러리	Dwrite.lib
DLL	Dwrite.dll

추가 정보

IDWriteFontFace