Функция 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
Указывает, как должны обрабатываться глифы, если они не поддерживаются. Этот параметр может иметь следующее значение.
| Значение | Значение |
|---|---|
|
Помечает неподдерживаемые глифы шестнадцатеричным значением 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 |