共用方式為

IXpsOMGlyphs：：GetFontFaceIndex 方法 (xpsobjectmodel.h)

  • 發行項

取得要使用的字型臉部索引。

只有在 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。

    <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

另請參閱

GetFontResource

IXpsOMFontResource

IXpsOMGlyphs

XML Paper Specification

XPS 檔案錯誤