Функция 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	Нет
Замечания по платформе	Не имеется

Назад в оглавление

На главную страницу

На оглавление справки