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

Статья
11/20/2024

Функция 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 и размер буфера, на который указывает pgi.

[out] pgi

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

[in] fl

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

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

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

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

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

Замечания

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wingdi.h (включая Windows.h)
библиотеки	Gdi32.lib
DLL	Gdi32.dll

См. также

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

шрифтов и текста

GetFontUnicodeRanges

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