CreateScalableFontResourceA, fonction (wingdi.h)

Article
11/20/2024

[La fonction CreateScalableFontResource est disponible pour être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être

modifié ou indisponible dans les versions ultérieures.]

La fonction CreateScalableFontResource crée un fichier de ressources de police pour une police évolutive.

Syntaxe

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

Paramètres

[in] fdwHidden

Spécifie si la police est une police en lecture seule. Ce paramètre peut être l’une des valeurs suivantes.

Valeur	Signification
0	La police dispose d’une autorisation de lecture/écriture.
1	La police dispose d’une autorisation en lecture seule et doit être masquée dans d’autres applications du système. Lorsque cet indicateur est défini, la police n’est pas énumérée par la fonction EnumFonts ou EnumFontFamilies.

[in] lpszFont

Pointeur vers une chaîne terminée par null spécifiant le nom du fichier de ressources de police à créer. Si ce paramètre spécifie un fichier de ressources de police existant, la fonction échoue.

[in] lpszFile

Pointeur vers une chaîne terminée par null spécifiant le nom du fichier de police scalable que cette fonction utilise pour créer le fichier de ressources de police.

[in] lpszPath

Pointeur vers une chaîne terminée par null spécifiant le chemin d’accès au fichier de police scalable.

Valeur de retour

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro.

Si lpszFontRes spécifie un fichier de police existant, GetLastError retourne ERROR_FILE_EXISTS

Remarques

La fonction CreateScalableFontResource est utilisée par les applications qui installent des polices TrueType. Une application utilise la fonction CreateScalableFontResource pour créer un fichier de ressources de police (généralement avec une extension de nom de fichier .fot), puis utilise la fonction AddFontResource pour installer la police. Le fichier de police TrueType (généralement avec une extension de nom de fichier .ttf) doit se trouver dans le sous-répertoire Système du répertoire Windows à utiliser par la fonction AddFontResource.

La fonction CreateScalableFontResource ne prend actuellement en charge que les polices évolutives de la technologie TrueType.

Lorsque le paramètre lpszFontFile spécifie uniquement un nom de fichier et une extension, le paramètre lpszCurrentPath doit spécifier un chemin d’accès. Lorsque le paramètre lpszFontFile spécifie un chemin d’accès complet, le paramètre lpszCurrentPath doit être NULL ou un pointeur vers NULL.

Quand seul un nom de fichier et une extension sont spécifiés dans le paramètre lpszFontFile et qu’un chemin d’accès est spécifié dans le paramètre lpszCurrentPath, la chaîne dans lpszFontFile est copiée dans le fichier .fot en tant que fichier .ttf qui appartient à cette ressource. Lorsque la fonction AddFontResource est appelée, le système d’exploitation suppose que le fichier .ttf a été copié dans le répertoire système (ou dans le répertoire Windows principal dans le cas d’une installation réseau). Le fichier .ttf n’a pas besoin d’être dans ce répertoire lorsque la fonction CreateScalableFontResource createScalableFontResource est appelée, car le paramètre lpszCurrentPath contient les informations du répertoire. Une ressource créée de cette façon ne contient pas d’informations de chemin d’accès absolus et peut être utilisée dans n’importe quelle installation.

Lorsqu’un chemin d’accès est spécifié dans le paramètre lpszFontFile et NULL est spécifié dans le paramètre lpszCurrentPath, la chaîne dans lpszFontFile est copiée dans le fichier .fot. Dans ce cas, lorsque la fonction AddFontResource est appelée, le fichier .ttf doit se trouver à l’emplacement spécifié dans le paramètre lpszFontFile lorsque la fonction CreateScalableFontResource a été appelée ; le paramètre lpszCurrentPath n’est pas nécessaire. Une ressource créée de cette façon contient des références absolues aux chemins d’accès et aux lecteurs et ne fonctionne pas si le fichier .ttf est déplacé vers un autre emplacement.

Note

L’en-tête wingdi.h définit CreateScalableFontResource comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	wingdi.h (include Windows.h)
bibliothèque	Gdi32.lib
DLL	Gdi32.dll

Voir aussi

AddFontResource

EnumFontFamilies

EnumFonts

fonctions de police et de texte

Vue d’ensemble des polices et du texte

Partager via