IXpsOMGlyphsEditor::SetGlyphMappings メソッド (xpsobjectmodel.h)

UnicodeString プロパティの UTF-16 スカラー値を、XPS_GLYPH_INDEX構造体の配列内のエントリにマップする方法を説明するXPS_GLYPH_MAPPING構造体の配列を設定します。

構文

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	1 つ以上の XPS_GLYPH_MAPPING 構造体のメンバーに無効な値があります。これは、文字列の長さと開始位置の合計が開始位置より小さい場合に発生する可能性があります。インデックス位置とインデックス長の合計が開始位置より小さい。インデックスの長さは 0 です。
E_POINTER	glyphMappings が NULL で、 glyphMappingCount が 0 より大きい。
XPS_E_MAPPING_OUT_OF_ORDER	1 つ以上のXPS_GLYPH_MAPPING 構造体では、要素の順序が外れている。

要件	値
サポートされている最小のクライアント	Windows 7、Windows Vista SP2 と Windows Vista 用プラットフォーム更新プログラム [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	xpsobjectmodel.h