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

Метод IDWriteFontFace::GetGlyphIndices (dwrite.h)

  • Статья

Возвращает номинальное сопоставление кодовых точек Юникода UCS4 с индексами глифов, как определено в таблице шрифта CMAP.

Синтаксис

HRESULT GetGlyphIndices(
  [in]  UINT32 const *codePoints,
        UINT32       codePointCount,
  [out] UINT16       *glyphIndices
);

Параметры

[in] codePoints

Тип: const UINT32*

Массив кодовых точек USC4, из которых можно получить номинальные индексы глифов. Массив должен быть выделен и содержать количество элементов, указанное в codePointCount.

codePointCount

Тип: UINT32

Количество элементов в массиве codePoints .

[out] glyphIndices

Тип: UINT16*

При возврате этого метода содержит указатель на массив номинальных индексов глифов, заполненных этой функцией.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Обратите внимание, что это сопоставление в основном предоставляется для обработчиков макетов строк, созданных на основе API физического шрифта. Из-за подстановки глифов OpenType и подстановки символов макета строки номинальное преобразование не всегда соответствует тому, как строка Юникода будет сопоставляться с индексами глифов при отрисовке с использованием определенного лица шрифта. Кроме того, обратите внимание, что селекторы вариантов Юникода предоставляют альтернативные сопоставления для символов и глифов. Этот вызов всегда возвращает вариант по умолчанию.

Если символы отсутствуют в шрифте, этот метод возвращает индекс 0, который является неопределенным глифом или глифом ".notdef". Если символ отсутствует в шрифте, idWriteFont::HasCharacter возвращает значение false, а GetUnicodeRanges не возвращает его в диапазоне.

Требования

   
Минимальная версия клиента Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновлением платформы для Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header dwrite.h
Библиотека Dwrite.lib
DLL Dwrite.dll

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

IDWriteFontFace