Функция CreateScalableFontResourceA (wingdi.h)
[Функция CreateScalableFontResource доступна для использования в операционных системах, указанных в разделе Требования. Это может быть
изменено или недоступно в последующих версиях.]
Функция CreateScalableFontResource создает файл ресурсов шрифта для масштабируемого шрифта.
Синтаксис
BOOL CreateScalableFontResourceA(
[in] DWORD fdwHidden,
[in] LPCSTR lpszFont,
[in] LPCSTR lpszFile,
[in] LPCSTR lpszPath
);
Параметры
[in] fdwHidden
Указывает, является ли шрифт шрифтом только для чтения. Этот параметр может принимать одно из указанных ниже значений.
| Значение | Значение |
|---|---|
|
Шрифт имеет разрешение на чтение и запись. |
|
Шрифт имеет разрешение только для чтения и должен быть скрыт от других приложений в системе. Если этот флаг установлен, шрифт не перечисляется функцией 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 |