Шаг 805 - CDC::GetFontData

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

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

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

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


Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Каев Артем - 5.02.2002