Функция GetGlyphIndices

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

Синтаксис

DWORD GetGlyphIndices(
  HDC hdc,       // дескриптор DC
  LPCTSTR lpstr, // преобразуемая строка
  int c,         // число символов в строке
  LPWORD pgi,    // массив индексов глифов
  DWORD fl       // параметры глифа
);

Параметры

hdc
[in] Дескриптор контекста устройства.
lpstr
[in] Указатель на строку, которая будет преобразована.
c
[in] Длина строки в pgi. Для функции ANSI это - итоговое число байтов (BYTE), а для функции Unicode это - итоговое число СЛОВ (WORD). 

Обратите внимание! на то, что для функции ANSI, буквы в кодовых страницах SBCS (набора однобайтовых символов) берут  по одному байту каждый, в то время как большинство букв в кодовых страницах DBCS (набора двухбайтовых символов)   берут два байта; для функции Unicode наиболее правильное определение символов Unicode (это в Основной Многоязычной плоскости - Basic Multilingual Plane(BMP)) - одно слово (WORD), в то время как в заменителях Unicode - это два слова  (WORD).
pgi
[out] Массив индексов глифов, соответствующих символам в строке.
fl
[in] Устанавливает, как глифы должны быть обработаны, если они не поддерживаются. Этим параметром может быть нижеследующее значение.
Значение Предназначение
GGI_MARK_NONEXISTING_GLYPHS Отмечает неподдерживаемые глифы шестнадцатеричным значением 0xffff.

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

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

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

Windows NT/2000/XP: Чтобы получить дополнительные сведения об ошибке, вызовите функцию GetLastError.

Смотри также

Обзор шрифты и текст, Функции, используемые шрифтами и текстом,  GetFontUnicodeRanges

Размещение и совместимость GetGlyphIndices

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Нет

Windows Me

Нет

Windows 98

Нет

Windows 95

Нет

Используемая библиотека

Gdi32.lib

Заголовочный файл

  

- объявлено в

Wingdi.h

- включено в

Windows.h

Unicode

Реализуется как версии Unicode и  ANSI. 

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz