IXpsOMGlyphsEditor：：SetGlyphMappings 方法 (xpsobjectmodel.h)

設定 XPS_GLYPH_MAPPING 結構的陣列，描述如何將 UnicodeString 屬性中的 UTF-16 純量值對應至 XPS_GLYPH_INDEX 結構數位中的專案。

語法

HRESULT SetGlyphMappings(
  [in] UINT32                  glyphMappingCount,
  [in] const XPS_GLYPH_MAPPING *glyphMappings
);

[in] glyphMappingCount

由 glyphMappings 參考的陣列中XPS_GLYPH_MAPPING結構數目。值為 0 會清除屬性。

[in] glyphMappings

包含字元對應值的 XPS_GLYPH_MAPPING 結構數位。如果 glyphMappingCount 為 0，則會忽略此參數，而且可以設定為 NULL。

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

傳回碼	描述
S_OK	此方法已成功。
E_INVALIDARG	一或多個 XPS_GLYPH_MAPPING 結構的成員具有無效的值。這可能會在下列情況下發生：字串長度和開始位置的總和小於開始位置;索引位置和索引長度的總和小於開始位置;索引的長度為 0。
E_POINTER	glyphMappings 為 NULL ，且 glyphMappingCount 大於 0。
XPS_E_MAPPING_OUT_OF_ORDER	在一或多個 XPS_GLYPH_MAPPING 結構中，元素順序不足。

需求	值
最低支援的用戶端	適用於 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