Поделиться через

Метод 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.

Комментарии

Список диапазонов символов, поддерживаемых шрифтом, полезен для таких сценариев, как выбор символов, отображение глифов и эффективный поиск шрифта. Это похоже на GetFontUnicodeRanges GDI, за исключением того, что он возвращает полный диапазон Юникода, а не только 16-разрядный UCS-2.

Эти диапазоны относятся к карте cmap, а не к OS/2::ulCodePageRange1.

Если этот метод недоступен, можно использовать метод IDWriteFontFace::GetGlyphIndices для проверка отсутствующих глифов. Метод возвращает индекс 0 для глифов, которых нет в шрифте.

Метод IDWriteFont::HasCharacter часто проще в тех случаях, когда необходимо проверка один символ или ряд одиночных символов подряд, например в резервном варианте шрифта.

Требования

Требование Значение
Минимальная версия клиента Windows 8 и обновление платформы для Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header dwrite_1.h
Библиотека Dwrite_1.lib
DLL Dwrite_1.dll

См. также раздел

IDWriteFontFace1