IDWriteFontFace::GetGlyphIndices メソッド (dwrite.h)

フォント 'CMAP' テーブルで定義されているグリフ インデックスを指す UCS4 Unicode コードの標準マッピングを返します。

構文

HRESULT GetGlyphIndices(
  [in]  UINT32 const *codePoints,
        UINT32       codePointCount,
  [out] UINT16       *glyphIndices
);

パラメーター

[in] codePoints

型: const UINT32*

わずかなグリフ インデックスを取得する USC4 コード ポイントの配列。 配列を割り当て、 codePointCount で指定された要素の数を格納できる必要があります。

codePointCount

種類: UINT32

codePoints 配列内の要素の数。

[out] glyphIndices

種類: UINT16*

このメソッドが戻るとき、 には、この関数によって塗りつぶされたわずかなグリフ インデックスの配列へのポインターが含まれます。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

このマッピングは、主に物理フォント API の上に構築された行レイアウト エンジン用に提供されることに注意してください。 OpenType グリフの置換と行レイアウト文字の置換により、特定のフォント面を使用してレンダリングするときに Unicode 文字列がグリフ インデックスにマップされる方法に、わずかな変換が常に対応するとは限りません。 また、Unicode バリアント セレクターでは、文字とグリフの代替マッピングが提供されることに注意してください。 この呼び出しでは、常に既定のバリアントが返されます。

フォントに文字が存在しない場合、このメソッドは、未定義のグリフまたは ".notdef" グリフであるインデックス 0 を返します。 文字がフォント内にない場合、IDWriteFont::HasCharacter は false を返し、GetUnicodeRanges は範囲内で返しません。

要件

関連項目

IDWriteFontFace