Функция AddFontResource


Функция AddFontResource добавляет ресурс шрифта из заданного файла в таблицу системного шрифта. Шрифт может впоследствии быть использован для вывода текста любым приложением.

Чтобы зарегистрировать шрифт как частный или не перечисляемый, используйте функцию AddFontResourceEx .

Синтаксис

int AddFontResource(
  LPCTSTRlpszFilename   // имя файла с шрифтом
);

Параметры

lpszFilename
[in] Указатель на строку символов с нулем в конце, которая содержит правильное имя файла шрифта. Этот параметр может задавать любой из ниже перечисленных файлов.

 

Расширение файла Описание
.fon Файл ресурса шрифта.
.fnt Файл необработанного растрового шрифта.
.ttf Файл необработанного шрифта TrueType.
.ttc Windows для Восточной Азии: набор шрифтов TrueType.
.fot Файл ресурса шрифта TrueType.
.otf Шрифт PostScript OpenType.
.mmm Файл ресурса шрифта Type 1 стандарта Multiple Master (MM). Он должен использоваться совместно с .pfm и .pfb файлами.
.pfb Файл битов шрифта Type 1. Он используется совместно с .pfm файлом.
.pfm Файл метрических параметров шрифта Type 1. Он используется совместно с .pfb файлом.

Windows 2000/XP: Чтобы добавить шрифт, информация о котором исходит из нескольких файлов ресурса, в параметре lpszFileName, указывают на строку с именами файлов, разделенными | (логическое OR) - например, abcxxxxx.pfm | abcxxxxx.pfb.

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

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

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

Замечания

Любое приложение, которое добавляет или удаляет шрифты из таблицы системного шрифта, должен уведомить другие окна о изменениях, отправляя сообщение WM_FONTCHANGE всем окнам верхнего уровня в операционной системе. Приложение должно отправить это сообщение путем вызова функции SendMessage и установкой в параметре hwnd флажка HWND_BROADCAST.

Когда приложению больше не нужен ресурс шрифта, который оно загрузило путем вызова функции AddFontResource, приложение должно удалить этот ресурс путем вызова функции RemoveFontResource .

Эта функция устанавливает шрифт только для текущего сеанса. Когда система перезагружается шрифт не будет присутствовать. Чтобы сохранить установленный шрифт даже после перезагрузки системы, он должен быть внесен в список в системном реестре.

Windows 95/98/Me: AddFontResourceW поддерживается подпрограммой Microsoft Layer for Unicode. Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в требованиях этой подпрограммы для систем Windows 95/98/Me.

Смотри также

Обзор шрифты и текст, Функции, используемые шрифтом и текстом, AddFontResourceEx, RemoveFontMemResourceEx, SendMessage

 

Размещение и совместимость AddFontResource

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

Gdi32.lib

Заголовочный файл

 

- объявлено в

Wingdi.h

- включено в

Windows.h

Unicode

 Реализуется как версии Unicode и  ANSI  в Windows NT /2000/XP.

Поддерживается также подпрограммой Microsoft Layer for Unicode

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz