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

  • Статья

Функция AddFontMemResourceEx добавляет ресурс шрифта из образа памяти в систему.

Синтаксис

HANDLE AddFontMemResourceEx(
  [in] PVOID pFileView,
  [in] DWORD cjSize,
  [in] PVOID pvResrved,
  [in] DWORD *pNumFonts
);

Параметры

[in] pFileView

Указатель на ресурс шрифта.

[in] cjSize

Количество байтов в ресурсе шрифта, на который указывает pbFont.

[in] pvResrved

Зарезервировано. Должно быть равно 0.

[in] pNumFonts

Указатель на переменную, указывающую количество установленных шрифтов.

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

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

Комментарии

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

Изображение памяти может содержать несколько шрифтов. При успешном выполнении этой функции pcFonts — это указатель на DWORD , значением которого является количество шрифтов, добавленных в систему в результате этого вызова. Например, это число может быть 2 для вертикальной и горизонтальной граней азиатского шрифта.

При успешном выполнении функции вызывающий объект этой функции может освободить память, на которую указывает pbFont , так как система сделала собственную копию памяти. Чтобы удалить установленные шрифты, вызовите Метод RemoveFontMemResourceEx. Однако при завершении процесса система выгрузит шрифты, даже если процесс не вызвал RemoveFontMemResource.

Требования

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

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

DESIGNVECTOR

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

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

RemoveFontMemResourceEx

SendMessage