IXpsOMGlyphs：：SetFontFaceIndex 方法 (xpsobjectmodel.h)

设置要使用的字体的索引。

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

语法

HRESULT SetFontFaceIndex(
  [in] SHORT fontFaceIndex
);

参数

[in] fontFaceIndex

要使用的字体的索引值。

返回值

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

注解

字体人脸索引属性的默认值为 –1，这意味着尚未设置字体索引或字体资源不是 TrueType 字体集合。

如果指定了此值并且不是 –1，则序列化期间会将“#<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>

要求

另请参阅

IXpsOMGlyphs

XML 纸张规范

XPS 文档错误