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

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

戻り値	説明
S_OK	メソッドが正常に実行されました。
E_NOT_SUFFICIENT_BUFFER	バッファーが小さすぎます。 actualRangeCount が maxRangeCount を超えています。

注釈

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

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

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

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

要件

要件	値
サポートされている最小のクライアント	Windows 7 のWindows 8とプラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2 のWindows Server 2012とプラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	dwrite_1.h
Library	Dwrite_1.lib
[DLL]	Dwrite_1.dll

こちらもご覧ください

IDWriteFont1