CreateScalableFontResourceW, fonction (wingdi.h)

[La fonction CreateScalableFontResource peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Exigences. Il peut s’agir de

modifié ou indisponible dans les versions suivantes.]

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

Syntaxe

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

Paramètres

[in] fdwHidden

Spécifie si la police est en lecture seule. Ce paramètre peut prendre les 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 des 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 un caractère Null spécifiant le nom du fichier de police scalable utilisé par cette fonction 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 retournée

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 polices 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 prend actuellement en charge uniquement 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.

Lorsque 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 main Windows 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 est appelée, car le paramètre lpszCurrentPath contient les informations du répertoire. Une ressource créée de cette manière ne contient pas d’informations absolues sur le chemin d’accès 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 que 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 manière 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.

Notes

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. La combinaison 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wingdi.h (inclure 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