Функция AddFontResourceEx

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

Синтаксис

int AddFontResourceEx(
  LPCTSTR
lpszFilename, // имя файла с шрифтом
  DWORD fl,             // характеристики шрифта
  PVOID pdv             // зарезервировано
);

Параметры

lpszFilename

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

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

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

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

 

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

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

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

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

Замечания

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

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

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

Смотри также

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

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Нет

Windows Me

Нет

Windows 98

Нет

Windows 95

Нет

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

Gdi32.lib

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

 

- объявлено в

Wingdi.h

- включено в

Windows.h

Unicode

Реализуется версиями в Unicode и ANSI

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

Не имеется

 

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

Hosted by uCoz