Функция GetFontData

Функция GetFontData извлекает данные о метриках шрифта TrueType.

Синтаксис

DWORD GetFontData(
  HDC hdc,           // дескриптор DC
  DWORD dwTable,     // имя таблицы метрик
  DWORD dwOffset,    // смещение внутри таблицы
  LPVOID lpvBuffer,  // буфер для возвращаемых данных
  DWORD cbData       // длина данных
);

Параметры

hdc
[in] Дескриптор контекста устройства.
dwTable
[in] Устанавливает название таблицы метрик шрифта, из которой должны извлекаться данные о шрифте . Этот параметр может идентифицировать одну из таблиц метрик, документированных в файлах спецификации шрифта TrueType, изданных корпорацией Microsoft Corporation. Если этот параметр равен нулю, информация извлекается, стартуя от начального файла шрифта.
dwOffset

[in] Устанавливает смещение от начала таблицы метрик шрифта до места, где функция должна начать отыскивать информацию. Если этот параметр равняется нулю, информация извлекается, начиная от начала таблицы, указанной параметром dwTable . Если это значение больше чем, или равно размеру таблицы, происходит ошибка.  

lpvBuffer

[out] Указатель на буфер, который принимает информацию  о шрифте. Если этот параметр - ПУСТО (NULL), функция возвращает размер буфера, необходимого для данных о шрифте.

cbData

[in] Устанавливает длину извлекаемой информации, в байтах. Если этот параметр равняется нулю, функция GetFontData возвращает размер данных, указанных в параметре dwTable .

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

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

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

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

Замечания

Приложение может иногда использовать функцию GetFontData, чтобы сохранить шрифт TrueType вместе с документом. Чтобы сделать это, приложение определяет, может ли шрифт быть внедрен, проверяя член otmfsType  структуры OUTLINETEXTMETRIC. Если бит 1 параметра otmfsType установлен, внедрение для шрифта не разрешается . Если бит 1 сброшен, шрифт может быть внедрен. Если бит 2 установлен, внедрение только для чтения. Если внедрение разрешается, приложение может извлечь весь файл шрифта, определяя нуль для параметров dwTable, dwOffset и cbData .

Если приложение пытается использовать эту функцию, чтобы извлечь информацию о шрифта не TrueType, происходит ошибка.

Смотри также

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

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 3.1 и выше

Windows Me

Да

Windows 98

Да

Windows 95

Да

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

Gdi32.lib

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

 

- объявлено в

Wingdi.h

- включено в

Windows.h

Unicode

Нет

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

Не имеется

 

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

Hosted by uCoz