Fonction TTEmbedFontEx (t2embapi.h)
Crée une structure de police contenant la police UCS-4 (32 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.
TTEmbedFontEx est utilisé de la même façon que TTEmbedFont, mais accepte un jeu de caractères donné dans UCS-4 (32 bits).
LONG TTEmbedFontEx(
[in] HDC hDC,
[in] ULONG ulFlags,
[in] ULONG ulCharSet,
[out] ULONG *pulPrivStatus,
[out] ULONG *pulStatus,
WRITEEMBEDPROC lpfnWriteToStream,
[in] LPVOID lpvWriteStream,
[in] ULONG *pulCharCodeSet,
[in] USHORT usCharCodeCount,
[in] USHORT usLanguage,
[in, optional] TTEMBEDINFO *pTTEmbedInfo
);
[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.
[in] ulCharSet
Indicateur spécifiant le jeu de caractères de la police à intégrer. Cet indicateur peut avoir l’une des valeurs suivantes.
[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.
[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] pulCharCodeSet
Pointeur vers la mémoire tampon contenant les codes de caractères UCS-4 facultatifs pour le sous-paramètre. 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 pulCharCodeSet. 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.
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.
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, consultez TTEmbedFont ; Pour plus d’informations sur l’incorporation de caractères Unicode à partir d’un fichier, consultez TTEmbedFontFromFileA.
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 |