IXpsOMGlyphs：：GetFontFaceIndex 方法 (xpsobjectmodel.h)

项目
03/13/2024

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

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

语法

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

参数

[out, retval] fontFaceIndex

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

返回值

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

返回代码	说明
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。

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

要求

要求	值
最低受支持的客户端	Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 \|UWP 应用]
目标平台	Windows
标头	xpsobjectmodel.h