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

Статья
11/20/2024

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

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

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

Синтаксис

BOOL CreateScalableFontResourceA(
  [in] DWORD  fdwHidden,
  [in] LPCSTR lpszFont,
  [in] LPCSTR lpszFile,
  [in] LPCSTR lpszPath
);

Параметры

[in] fdwHidden

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

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

[in] lpszFont

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

[in] lpszFile

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

[in] lpszPath

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

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

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

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

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

Замечания

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

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

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

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

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wingdi.h (включая Windows.h)
библиотеки	Gdi32.lib
DLL	Gdi32.dll

См. также

AddFontResource

EnumFontFamilies

EnumFonts

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

шрифтов и текста

Поделиться через