IDWriteFont1::GetUnicodeRanges メソッド (dwrite_1.h)

フォントでサポートされている文字範囲の一覧を取得します。

構文

HRESULT GetUnicodeRanges(
                  UINT32               maxRangeCount,
  [out, optional] DWRITE_UNICODE_RANGE *unicodeRanges,
  [out]           UINT32               *actualRangeCount
);

パラメーター

maxRangeCount

型: UINT32

クライアントから渡される文字範囲の最大数。

[out, optional] unicodeRanges

型: DWRITE_UNICODE_RANGE*

文字範囲で埋められた DWRITE_UNICODE_RANGE 構造体の配列。

[out] actualRangeCount

型: UINT32*

最大カウントに関係なく、実際の文字数へのポインター。

戻り値

型: HRESULT

このメソッドは、これらの値のいずれかを返すことができます。

備考

フォントでサポートされている文字範囲の一覧は、文字選択、グリフ表示、効率的なフォント選択検索などのシナリオに役立ちます。 GetUnicodeRanges は GDI の GetFontUnicodeRanges に似ていますが、16 ビット UCS-2 だけでなく、完全な Unicode 範囲を返す点が異なります。

これらの範囲は、OS/2::ulCodePageRange1 ではなく cmap からの範囲です。

このメソッドが使用できない場合は、IDWriteFontFace::GetGlyphIndices メソッドを使用して、不足しているグリフを確認できます。 このメソッドは、フォントに存在しないグリフの 0 インデックスを返します。

IDWriteFont::HasCharacter メソッドは、フォント フォールバックなど、1 つの文字または一連の文字を連続してチェックする必要がある場合に、多くの場合、より簡単です。

必要条件

関連項目

IDWriteFont1