TTEmbedFont, fonction (t2embapi.h)

  • Article
  • 3 minutes de lecture

Crée une structure de police contenant la police à caractères larges sous-ensemble (16 bits). La police actuelle du contexte de périphérique (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 de l’appareil.

[in] ulFlags

Indicateur spécifiant la demande d’incorporation. Cet indicateur peut avoir zéro ou plusieurs 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 tant que caractères 16 bits ou UCS-4, selon les besoins 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 à incorporer. 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 symbole, nécessitant un encodage de caractères 16 bits.

[out] pulPrivStatus

Pointeur vers un indicateur indiquant les privilèges d’incorporation 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 licence restreinte.

[out] pulStatus

Pointeur vers un champ de bits contenant des informations d’état sur la demande d’incorporation. Ce champ est rempli à la fin 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. Voir 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-réinitialisation. 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 dans la table de noms à conserver lors de la sous-réinitialisation. Définissez la valeur 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 de laquelle l’objet de police incorporé peut être référencé légitimement. 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 documents 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.

Sinon, retourne un code d’erreur décrit dans Embedding-Function Error Messages.

Notes

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

   
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