共用方式為

IXpsOMGlyphs：：SetFontFaceIndex 方法 (xpsobjectmodel.h)

  • 發行項

設定要使用的字型臉部索引。

只有在 GetFontResource 傳回代表 TrueType 字型集合的 IXpsOMFontResource 介面時，才會使用此值。

語法

HRESULT SetFontFaceIndex(
  [in] SHORT fontFaceIndex
);

參數

[in] fontFaceIndex

要使用的字型臉部索引值。

傳回值

方法會傳回 HRESULT。 可能的值包括下列數據表中的值，但不限於這些值。 如需此表格中未列出的 XPS 檔 API 傳回值的相關信息，請參閱 XPS 檔錯誤。

傳回碼 描述
S_OK
 此方法已成功。
E_INVALIDARG
 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 Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 xpsobjectmodel.h

另請參閱

IXpsOMGlyphs

XML Paper Specification

XPS 檔案錯誤