Функция AddFontResourceExA (wingdi.h)

  • Статья

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

Синтаксис

int AddFontResourceExA(
  [in] LPCSTR name,
  [in] DWORD  fl,
  [in] PVOID  res
);

Параметры

[in] name

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

Расширение файла Значение
.fon
 Файл ресурсов шрифта.
.Fnt
 Необработанный файл шрифта точечных рисунков.
.ttf
 Необработанный файл TrueType.
.Ttc
 Windows для Восточной Азии: коллекция шрифтов TrueType.
.Фот
 Файл ресурсов TrueType.
.Otf
 Шрифт PostScript OpenType.
.Ммм
 несколько master файл ресурсов шрифта Type1. Его необходимо использовать с PFM- и PFB-файлами.
.Pfb
 Введите файл 1 бит шрифта. Он используется с PFM-файлом.
.Pfm
 Введите файл метрик шрифта 1. Он используется с PFB-файлом.
 

Чтобы добавить шрифт, сведения которого поступают из нескольких файлов ресурсов, наведите указатель lpszFileName на строку с именами файлов, разделенными | --например, abcxxxxx.pfm | abcxxxxx.pfb.

[in] fl

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

Значение Значение
FR_PRIVATE
 Указывает, что только процесс, который вызвал функцию AddFontResourceEx , может использовать этот шрифт. Если имя шрифта совпадает с общедоступным шрифтом, будет выбран частный шрифт. После завершения процесса система удалит все шрифты, установленные процессом, с помощью функции AddFontResourceEx .
FR_NOT_ENUM
 Указывает, что ни процесс, включая процесс, который вызвал функцию AddFontResourceEx , не может перечислить этот шрифт.

[in] res

Зарезервировано. Должен равняться нулю.

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

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

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

Комментарии

Эта функция позволяет процессу использовать шрифты без предоставления другим процессам доступа к шрифтам.

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

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

Шрифт, указанный в реестре и установленный в расположении, отличном от папки %windir%\fonts\, не может быть изменен, удален или заменен, если он загружен в любом сеансе. Чтобы изменить один из этих шрифтов, его необходимо сначала удалить, вызвав Метод RemoveFontResource, удалить из реестра шрифтов (HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts) и перезапустить систему. После перезапуска системы шрифт больше не будет загружен и может быть изменен.

Примечание

Заголовок wingdi.h определяет AddFontResourceEx как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header wingdi.h (включая Windows.h)
Библиотека Gdi32.lib
DLL Gdi32.dll

См. также раздел

Функции шрифта и текста

Общие сведения о шрифтах и тексте

RemoveFontResourceEx

SendMessage