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

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

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

구문

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

매개 변수

[out, retval] fontFaceIndex

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

반환 값

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

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_POINTER	fontFaceIndex 는 NULL입니다.

설명

글꼴 리소스는 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>

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트가 포함된 Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	xpsobjectmodel.h

추가 정보

GetFontResource

IXpsOMFontResource

IXpsOMGlyphs

XML Paper Specification

XPS 문서 오류