TTEmbedFontFromFileA, fonction (t2embapi.h)

Article
08/26/2023

Crée une structure de police contenant la police de caractères larges (16 bits) sous-ensemble. Un fichier externe fournit les informations de police.

Cette fonction transmet les données à une routine de rappel définie par le client pour l’insertion dans le flux de documents.

Syntaxe

LONG TTEmbedFontFromFileA(
  [in]           HDC            hDC,
  [in]           LPCSTR         szFontFileName,
  [in]           USHORT         usTTCIndex,
  [in]           ULONG          ulFlags,
  [in]           ULONG          ulCharSet,
  [out]          ULONG          *pulPrivStatus,
  [out]          ULONG          *pulStatus,
                 WRITEEMBEDPROC lpfnWriteToStream,
  [in]           LPVOID         lpvWriteStream,
  [in]           USHORT         *pusCharCodeSet,
  [in]           USHORT         usCharCodeCount,
  [in]           USHORT         usLanguage,
  [in, optional] TTEMBEDINFO    *pTTEmbedInfo
);

Paramètres

[in] hDC

Handle de contexte d’appareil.

[in] szFontFileName

Nom du fichier de police et chemin d’accès à incorporer. Il s’agit d’une chaîne ANSI.

[in] usTTCIndex

Index de base zéro dans le fichier de police (TTC) identifiant la police physique à incorporer. Si le fichier contient une police unique (par exemple, un fichier de plan TTF ou OTF), ce paramètre doit être défini sur 0.

[in] ulFlags

Indicateur spécifiant la demande d’incorporation. Cet indicateur peut avoir zéro ou plusieurs des valeurs suivantes.

Valeur	Signification
TTEMBED_EMBEDEUDC	Incluez les données de fichier de police EUDC associées avec la structure de police.
TTEMBED_RAW	Retourne une structure de police contenant le jeu de caractères complet, non compressé. Il s’agit du comportement par défaut de la fonction.
TTEMBED_SUBSET	Retourne une police sous-ensemble contenant uniquement les glyphes indiqués par le paramètre pusCharCodeSet ou pulCharCodeSet . Ces codes de caractères doivent être indiqués comme des caractères 16 bits ou UCS-4 en fonction du paramètre.
TTEMBED_TTCOMPRESSED	Retourne une structure de police compressée.

[in] ulCharSet

Indicateur spécifiant le jeu de caractères de la police à intégrer. Cet indicateur peut avoir l’une des valeurs suivantes.

Valeur	Signification
CHARSET_UNICODE	Jeu de caractères Unicode, nécessitant un encodage de caractères 16 bits.
CHARSET_SYMBOL	Jeu de caractères de symboles, nécessitant un encodage de caractères 16 bits.

[out] pulPrivStatus

Pointeur vers l’indicateur indiquant l’incorporation des privilèges de la police. Cet indicateur peut avoir l’une des valeurs suivantes. Cette fonction retourne la licence la moins restrictive accordée.

Valeur	Signification
EMBED_PREVIEWPRINT	Aperçu et incorporation d’impression.
EMBED_EDITABLE	Incorporation modifiable.
EMBED_INSTALLABLE	Incorporation installable.
EMBED_NOEMBEDDING	Incorporation de licences restreintes.

[out] pulStatus

Pointeur vers un champ de bits contenant status informations sur la demande d’incorporation. Ce champ est rempli à l’achèvement de cette fonction. Aucun bits n’est actuellement défini pour ce paramètre.

lpfnWriteToStream

Pointeur vers la fonction de rappel définie par le client qui écrit la structure de police dans le flux de documents. Consultez WRITEEMBEDPROC.

[in] lpvWriteStream

Jeton pour représenter le flux de sortie.

[in] pusCharCodeSet

Pointeur vers la mémoire tampon contenant les codes de caractères Unicode facultatifs pour la sous-configuration. Ce champ est utilisé uniquement pour la sous-définition d’une police et est ignoré si theulFlagsfield ne spécifie pas TTEMBED_SUBSET.

[in] usCharCodeCount

Nombre de caractères dans la liste des caractères indiqués par pusCharCodeSet. Ce champ est utilisé uniquement pour la sous-définition d’une police et est ignoré si le champ ulFlags ne spécifie pas TTEMBED_SUBSET.

[in] usLanguage

Spécifie la langue de la table de noms à conserver lors de la sous-création. Définissez sur 0 pour conserver toutes les langues. Ce champ est utilisé uniquement pour la sous-définition d’une police et est ignoré si le champ ulFlags ne spécifie pas TTEMBED_SUBSET.

[in, optional] pTTEmbedInfo

Pointeur vers une structure TTEMBEDINFO contenant les URL à partir desquelles l’objet de police incorporé peut être référencé de manière légitime. Si pTTEmbedInfo a la valeur NULL, aucune URL n’est ajoutée à l’objet de police incorporé et aucune vérification d’URL ne se produit lorsque le client appelle la fonction TTLoadEmbeddedFont .

Valeur retournée

Si l’incorporation réussit, retourne E_NONE.

La structure de police est incorporée dans le flux de document par le client. pulPrivStatus est défini, indiquant les privilèges d’incorporation de la police ; et pulStatus est défini pour fournir les résultats de l’opération d’incorporation.

Dans le cas contraire, retourne un code d’erreur décrit dans Messages d’erreur d’incorporation de la fonction.

Remarques

Cette fonction fait référence à une routine de rappel définie par le client pour incorporer la structure de police dans le flux de document.

Les clients sont chargés de déterminer et d’indiquer le jeu de caractères de la police.

Pour plus d’informations sur l’incorporation de caractères Unicode à partir d’un contexte d’appareil, consultez TTEmbedFont ; Pour plus d’informations sur l’incorporation de caractères UCS-4 à partir d’un contexte d’appareil, consultez TTEmbedFontEx.

Configuration requise


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	t2embapi.h
Bibliothèque	T2embed.lib
DLL	T2embed.dll

Voir aussi

Partager via