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

Статья
08/27/2023

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

Синтаксис

DWORD GetFontData(
  [in]  HDC   hdc,
  [in]  DWORD dwTable,
  [in]  DWORD dwOffset,
  [out] PVOID pvBuffer,
  [in]  DWORD cjBuffer
);

Параметры

[in] hdc

Дескриптор контекста устройства.

[in] dwTable

Имя таблицы метрик шрифта, из которой должны быть получены данные шрифта. Этот параметр может определить одну из таблиц метрик, задокументированных в спецификации Файлов шрифтов TrueType, опубликованной корпорацией Майкрософт. Если этот параметр равен нулю, сведения извлекаются начиная с начала файла шрифтов TrueType или из начала данных для выбранного шрифта для файлов коллекции TrueType. Чтобы получить данные из начала файла для файлов коллекции TrueType, укажите ttcf (0x66637474).

[in] dwOffset

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

[out] pvBuffer

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

[in] cjBuffer

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

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

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

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

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll

См. также раздел

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

Общие сведения о шрифтах и тексте

GetTextMetrics

OUTLINETEXTMETRIC

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