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


CDC::GetFontData

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

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.

Требования

Header: afxwin.h

См. также

Ссылки

Класс CDC

Диаграмма иерархии

CDC::GetOutlineTextMetrics

GetFontData

OUTLINETEXTMETRIC