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 纸张规范

XPS 文档错误