IXpsOMGlyphs::GetFontFaceIndex 메서드(xpsobjectmodel.h)

사용할 글꼴 면의 인덱스 를 가져옵니다.

이 값은 GetFontResource가 TrueType 글꼴 컬렉션을 나타내는 IXpsOMFontResource 인터페이스를 반환하는 경우에만 사용됩니다.

구문

HRESULT GetFontFaceIndex(
  [out, retval] SHORT *fontFaceIndex
);

매개 변수

[out, retval] fontFaceIndex

글꼴 면의 인덱스 값입니다. 글꼴 면이 설정되지 않은 경우 –1이 반환됩니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값은 다음 표에 있는 값을 포함하지만 이에 국한되지 않습니다. 이 표에 나열되지 않은 XPS 문서 API 반환 값에 대한 자세한 내용은 XPS 문서 오류를 참조하세요.

설명

글꼴 리소스는 GetFontResource 메서드를 호출하여 가져옵니다.

글꼴 면이 설정되지 않았거나 글꼴에서 지원되지 않는 경우 fontFaceIndex에서 –1 값이 반환됩니다. 기존 XPS 문서 파일에서 문자 모양을 로드하면 fontFaceIndex 값 –1은 FontUri 특성에 #index 조각이 포함되지 않았음을 나타냅니다.

FixedPage의 다음 태그에서 Glyphs 요소의 FontUri 특성 값은 입니다../Resources/Fonts/Font.TTF#1. 이 경우 GetFontFaceIndex 는 fontFaceIndex에서 1 값을 반환합니다.

    <FixedPage Height="1056" Width="816" xml:lang="en-US"
    xmlns="http://schemas.microsoft.com/xps/2005/06">
      <Glyphs
      OriginX="96"
      OriginY="96"
      UnicodeString="This is Page 1!"
      FontUri="../Resources/Fonts/Font.TTF#1"
      FontRenderingEmSize="16" />
    </FixedPage>

요구 사항

추가 정보

GetFontResource

IXpsOMFontResource

IXpsOMGlyphs

XML Paper Specification

XPS 문서 오류