共用方式為

IDWriteFontFace1：：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。

備註

字型所支援的字元範圍清單適用於字元選擇、圖像顯示，以及有效率的字型選取查閱等案例。 這類似於 GDI 的 GetFontUnicodeRanges，不同之處在於它會傳回完整的 Unicode 範圍，而不只是 16 位 UCS-2。

這些範圍來自 cmap，而不是 OS/2：：ulCodePageRange1。

如果這個方法無法使用，您可以使用 IDWriteFontFace：：GetGlyphIndices 方法來檢查遺漏的字元。 方法會針對字型中不存在的字元傳回 0 索引。

在您需要連續檢查單一字元或一系列單一字元的情況下， IDWriteFont：：HasCharacter 方法通常比較簡單，例如字型後援。

規格需求

需求 值
最低支援的用戶端 適用於 Windows 7 的 Windows 8 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 適用於 Windows Server 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 dwrite_1.h
程式庫 Dwrite_1.lib
Dll Dwrite_1.dll

另請參閱

IDWriteFontFace1