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

  • 아티클

사용할 글꼴 면의 인덱스 를 설정합니다.

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

구문

HRESULT SetFontFaceIndex(
  [in] SHORT fontFaceIndex
);

매개 변수

[in] fontFaceIndex

사용할 글꼴 면의 인덱스 값입니다.

반환 값

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

반환 코드 Description
S_OK
 메서드가 성공했습니다.
E_INVALIDARG
 fontFaceIndex 값이 잘못되었습니다. –1보다 크거나 같은 정수여야 합니다.

설명

글꼴 얼굴 인덱스 속성의 기본값은 –1입니다. 즉, 글꼴 인덱스가 설정되지 않았거나 글꼴 리소스가 TrueType 글꼴 컬렉션이 아님을 의미합니다.

이 값을 지정하고 –1이 아닌 경우 serialization 중에 "#<Index>"가 글꼴 URI에 추가됩니다. <여기서 Index>는 SetFontFaceIndex에서 설정한 값입니다.

FixedPage의 다음 태그는 fontFaceIndex 를 1로 설정한 결과를 보여 줍니다. Glyphs 요소의 FontUri 특성에는 글꼴 면의 ../Resources/Fonts/Font.TTF#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용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 xpsobjectmodel.h

추가 정보

IXpsOMGlyphs

XML Paper Specification

XPS 문서 오류