Fonction TTEmbedFont (t2embapi.h)

Crée une structure de police contenant la police de caractères larges (16 bits) sous-ensemble. La police actuelle du contexte d’appareil (hDC) 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 TTEmbedFont(
  [in]           HDC            hDC,
  [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] 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 en 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 document. 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 le champ ulFlags 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 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

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 UCS-4, consultez TTEmbedFontEx. Pour plus d’informations sur l’incorporation de caractères de police à partir d’un fichier, consultez TTEmbedFontFromFileA.

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

Voir aussi

TTEMBEDINFO

TTEmbedFontEx

TTEmbedFontFromFileA

TTLoadEmbeddedFont