次の方法で共有

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 2012 および Windows Server 2008 R2 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー dwrite_1.h
ライブラリ Dwrite_1.lib
DLL Dwrite_1.dll

関連項目

IDWriteFont1