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

Статья
03/04/2024

[Функция CreateScalableFontResource доступна для использования в операционных системах, указанных в разделе Требования. Это может быть

изменено или недоступно в последующих версиях.]

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

Синтаксис

BOOL CreateScalableFontResourceW(
  [in] DWORD   fdwHidden,
  [in] LPCWSTR lpszFont,
  [in] LPCWSTR lpszFile,
  [in] LPCWSTR lpszPath
);

Параметры

[in] fdwHidden

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

Значение	Значение
0	Шрифт имеет разрешение на чтение и запись.
1	Шрифт имеет разрешение только для чтения и должен быть скрыт от других приложений в системе. Если этот флаг установлен, шрифт не перечисляется функцией EnumFonts или EnumFontFamilies .

[in] lpszFont

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

[in] lpszFile

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

[in] lpszPath

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

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

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

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

Если lpszFontRes указывает существующий файл шрифта, GetLastError возвращает ERROR_FILE_EXISTS

Функция CreateScalableFontResource используется приложениями, устанавливающими шрифты TrueType. Приложение использует функцию CreateScalableFontResource для создания файла ресурсов шрифта (обычно с расширением FOT), а затем использует функцию AddFontResource для установки шрифта. Файл шрифта TrueType (обычно с расширением имени файла .ttf) должен находиться в подкаталоге System каталога Windows, который будет использоваться функцией AddFontResource .

Функция CreateScalableFontResource в настоящее время поддерживает только масштабируемые шрифты технологии TrueType.

Если параметр lpszFontFile указывает только имя файла и расширение, параметр lpszCurrentPath должен указывать путь. Если параметр lpszFontFile указывает полный путь, параметр lpszCurrentPath должен иметь значение NULL или указатель на NULL.

Если в параметре lpszFontFile указаны только имя и расширение файла, а путь указан в параметре lpszCurrentPath , строка в lpszFontFile копируется в FOT-файл как файл .ttf, принадлежащий этому ресурсу. При вызове функции AddFontResource операционная система предполагает, что .ttf файл был скопирован в системный каталог (или в каталог main Windows в случае сетевой установки). Файл .ttf не должен находиться в этом каталоге при вызове функции CreateScalableFontResource , так как параметр lpszCurrentPath содержит сведения о каталоге. Ресурс, созданный таким образом, не содержит абсолютных сведений о пути и может использоваться в любой установке.

Если путь указан в параметре lpszFontFile , а null указан в параметре lpszCurrentPath , строка в lpszFontFile копируется в FOT-файл. В этом случае при вызове функции AddFontResource файл .ttf должен находиться в расположении, указанном в параметре lpszFontFile при вызове функции CreateScalableFontResource ; параметр lpszCurrentPath не требуется. Ресурс, созданный таким образом, содержит абсолютные ссылки на пути и диски и не работает, если файл .ttf перемещается в другое расположение.

Примечание

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

Требования

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