IXpsOMGlyphs::SetFontFaceIndex 方法 (xpsobjectmodel.h)
设置要使用的字体的索引。
仅当 GetFontResource 返回表示 TrueType 字体集合的 IXpsOMFontResource 接口时,才使用此值。
语法
HRESULT SetFontFaceIndex(
[in] SHORT fontFaceIndex
);
参数
[in] fontFaceIndex
要使用的字体的索引值。
返回值
该方法返回 HRESULT。 可能的值包括但不限于下表中的值。 有关此表中未列出的 XPS 文档 API 返回值的信息,请参阅 XPS 文档错误。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
fontFaceIndex 的值无效;它必须是大于或等于 –1 的整数。 |
注解
字体人脸索引属性的默认值为 –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>
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | xpsobjectmodel.h |