METODE IDWriteFontFace1::GetUnicodeRanges (dwrite_1.h)

Mengambil daftar rentang karakter yang didukung oleh font.

Sintaks

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

Parameter

maxRangeCount

Jenis: UINT32

Jumlah maksimum rentang karakter yang diteruskan dari klien.

[out, optional] unicodeRanges

Jenis: DWRITE_UNICODE_RANGE*

Array struktur DWRITE_UNICODE_RANGE yang diisi dengan rentang karakter.

[out] actualRangeCount

Jenis: UINT32*

Penunjuk ke jumlah rentang karakter aktual, terlepas dari jumlah maksimumnya.

Menampilkan nilai

Jenis: HRESULT

Metode ini dapat mengembalikan salah satu nilai ini.

Mengembalikan nilai	Deskripsi
S_OK	Metode berhasil dijalankan.
E_NOT_SUFFICIENT_BUFFER	Buffer terlalu kecil. ActualRangeCount lebih dari maxRangeCount.

Keterangan

Daftar rentang karakter yang didukung oleh font berguna untuk skenario seperti pemilihan karakter, tampilan glyph, dan pencarian pilihan font yang efisien. Ini mirip dengan GetFontUnicodeRanges GDI, kecuali bahwa ia mengembalikan rentang Unicode penuh, bukan hanya UCS-2 16-bit.

Rentang ini berasal dari cmap, bukan OS/2::ulCodePageRange1.

Jika metode ini tidak tersedia, Anda dapat menggunakan metode IDWriteFontFace::GetGlyphIndices untuk memeriksa glyph yang hilang. Metode mengembalikan indeks 0 untuk glyph yang tidak ada dalam font.

Metode IDWriteFont::HasCharacter sering lebih sederhana dalam kasus di mana Anda perlu memeriksa satu karakter atau serangkaian karakter tunggal berturut-turut, seperti dalam fallback font.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 dan Pembaruan Platform untuk Windows 7 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 dan Platform Update untuk Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	dwrite_1.h
Pustaka	Dwrite_1.lib
DLL	Dwrite_1.dll

Lihat juga

IDWriteFontFace1