IXpsOMGlyphs::GetFontFaceIndex 方法 (xpsobjectmodel.h)

获取要使用的字体的索引。

仅当 GetFontResource 返回表示 TrueType 字体集合的 IXpsOMFontResource 接口时,才使用此值。

语法

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

参数

[out, retval] fontFaceIndex

字体的索引值。 如果尚未设置字体,则返回 –1。

返回值

该方法返回 HRESULT。 可能的值包括但不限于后面的表中的值。 有关此表中未列出的 XPS 文档 API 返回值的信息,请参阅 XPS 文档错误

返回代码 说明
S_OK
方法成功。
E_POINTER
fontFaceIndexNULL

注解

字体资源是通过调用 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、带 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 纸张规范

XPS 文档错误