Функция GetGlyphIndicesA (wingdi.h)

  • Статья

Функция GetGlyphIndices преобразует строку в массив индексов глифов. С помощью функции можно определить, существует ли глиф в шрифте.

Синтаксис

DWORD GetGlyphIndicesA(
  [in]  HDC    hdc,
  [in]  LPCSTR lpstr,
  [in]  int    c,
  [out] LPWORD pgi,
  [in]  DWORD  fl
);

Параметры

[in] hdc

Дескриптор контекста устройства.

[in] lpstr

Указатель на преобразуемую строку.

[in] c

Длина строки , на которую указывает lpstr , и размер (в WORD) буфера, на который указывает pgi.

[out] pgi

Этот буфер должен иметь размер c. При успешном возвращении содержит массив индексов глифов, соответствующих символам в строке.

[in] fl

Указывает, как должны обрабатываться глифы, если они не поддерживаются. Этот параметр может иметь следующее значение.

Значение Значение
GGI_MARK_NONEXISTING_GLYPHS
 Помечает неподдерживаемые глифы шестнадцатеричным значением 0xffff.

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

Если функция выполнена успешно, она возвращает количество преобразованных байтов (для функции ANSI) или WORD (для функции Юникода).

Если функция завершается сбоем, возвращаемое значение будет GDI_ERROR.

Комментарии

Эта функция пытается определить представление с одним глифом для каждого символа в строке, на которую указывает lpstr. Хотя это полезно для некоторых низкоуровневых целей (например, для работы с файлами шрифтов), приложения более высокого уровня, которые хотят сопоставить строку с глифами, обычно хотят использовать функции Uniscribe .

Примечание

Заголовок wingdi.h определяет GetGlyphIndices в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header wingdi.h (включая Windows.h)
Библиотека Gdi32.lib
DLL Gdi32.dll

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

Функции шрифта и текста

Общие сведения о шрифтах и тексте

GetFontUnicodeRanges