На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

GetFontData



The GetFontData function retrieves font metric data for a TrueType font.

DWORD GetFontData(

HDC hdc, // handle of device context
DWORD dwTable, // metric table to query
DWORD dwOffset, // offset into table being queried
LPVOID lpvBuffer, // address of buffer for returned data
DWORD cbData // length of data to query
);


Parameters

hdc

Identifies the device context.

dwTable

Specifies the name of a font metric table from which the font data is to be retrieved. This parameter can identify one of the metric tables documented in the TrueType Font Files specification published by Microsoft Corporation. If this parameter is zero, the information is retrieved starting at the beginning of the font file.

dwOffset

Specifies the offset from the beginning of the font metric table to the location where the function should begin retrieving information. If this parameter is zero, the information is retrieved starting at the beginning of the table specified by the dwTable parameter. If this value is greater than or equal to the size of the table, an error occurs.

lpvBuffer

Points to a buffer to receive the font information. If this parameter is NULL, the function returns the size of the buffer required for the font data.

cbData

Specifies the length, in bytes, of the information to be retrieved. If this parameter is zero, GetFontData returns the size of the data specified in the dwTable parameter.



Return Values

If the function succeeds, the return value is the number of bytes returned.
If the function fails, the return value is GDI_ERROR.

Remarks

An application can sometimes use the GetFontData function to save a TrueType font with a document. To do this, the application determines whether the font can be embedded by checking the otmfsType member of the OUTLINETEXTMETRIC structure. If bit 1 of otmfsType is set, embedding is not permitted for the font. If bit 1 is clear, the font can be embedded. If bit 2 is set, the embedding is read-only. If embedding is permitted, the application can retrieve the entire font file, specifying zero for the dwTable, dwOffset, and cbData parameters.

If an application attempts to use this function to retrieve information for a non-TrueType font, an error occurs.

See Also

GetTextMetrics, OUTLINETEXTMETRIC


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

GetFontData



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

DWORD GetFontData(

HDC hdc, // РУЧКА контекста устройства DWORD dwTable, // метрической таблицы на запрос DWORD dwOffset, // смещение в таблицу, спрашиванную LPVOID lpvBuffer, // адрес буфера для возвращанной длины данных DWORD cbData // данных на запрос
);


Параметры

hdc

Идентифицирует контекст устройства.

dwTable

Определяет имя шрифтовой метрической таблицы из которой шрифтовые данные должны быть извлечены. Этот параметр может идентифицировать одной из метрических таблиц подтвержденных в Шрифтовой спецификации Файлов TrueType опубликованной Корпорацией Микрософт. Если этот параметр является нулем, информация является извлеченным запуском в начале шрифтового файла.

dwOffset

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

lpvBuffer

Точки на буфер, чтобы получать шрифтовую информацию. Если этот параметр НЕДЕЙСТВИТЕЛЕН, функция возвращает размер буфера необходимый для шрифтовых данных.

cbData

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



Обратные Величины

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

Замечания

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

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

Смотри Также

GetTextMetrics, OUTLINETEXTMETRIC


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz