CDC::GetFontData

Статья
02/20/2013

Извлекает данные из файла шрифт- масштабируемого метрики шрифтов.

DWORD GetFontData(
   DWORD dwTable,
   DWORD dwOffset,
   LPVOID lpData,
   DWORD cbData 
) const;

Параметры

dwTable
Указывает имя метрической возвращаемой таблицы.Этот параметр может быть одной из документированных метрических таблиц в спецификации файлов шрифты TrueType публикованной корпорация Майкрософт.Если этот параметр равен 0, то информацию, полученную запускать в начале файла шрифта.
dwOffset
Указывает смещение от начала таблицы, для которой начинается извлечение сведений.Если этот параметр равен 0, то информацию, полученную запускать в начале таблицы, указанной параметром dwTable.Если это значение больше или равно размеру таблицы, то GetFontData возвращают 0.
lpData
Указатель на буфер, который будет получать данные о шрифте.Если это значение NULL, то функция возвращает размер буфера необходима для данных о шрифте, указанных в параметре dwTable.
cbData
Указывает длину в байтах данных для извлечения.Если этот параметр равен 0, то GetFontData возвращает размер данных, указанных в параметре dwTable.

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

Указывает число байтов, возвращенных в буфере, заданном в lpData если функция успешно; в противном случае – 1.

Заметки

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

Приложение может иногда использование функции-члена GetFontData для сохранения шрифты TrueType с документом.Для этого приложение указывает, является ли шрифт может быть внедрен, а затем получает весь файл шрифта, указав 0 для dwTable, dwOffset и параметры cbData.

Приложения могут определить, является ли шрифт может быть внедрен, проверив элемент otmfsType структуры OUTLINETEXTMETRIC.Если бит равен 1 otmfsType установлен, то не разрешен для внедрения шрифта.Если бит равен 1 ясн, то можно внедрять шрифт.Если бит равен 2, то устанавливается внедрить доступен только для чтения.

Если приложение пытается использовать эту функцию для получения сведений для шрифта non-TrueType, функция-член GetFontData возвращает – 1.