Fonction TTEnableEmbeddingForFacename (t2embapi.h)

  • Article

Ajoute ou supprime les noms de visage de la liste d’exclusions de police de type.

Syntaxe

LONG TTEnableEmbeddingForFacename(
  [in] LPCSTR lpszFacename,
  [in] BOOL   bEnable
);

Paramètres

[in] lpszFacename

Pointeur vers le nom de visage de la police à ajouter ou à supprimer de la liste d’exclusions de police.

[in] bEnable

Opération de contrôle booléen sur la liste d’exclusion de police de type. Si ce n’est pas zéro, le nom de visage est supprimé de la liste ; si zéro, le nom du visage est ajouté à la liste.

Valeur retournée

En cas de réussite, retourne E_NONE.

Le nom de visage indiqué par lpszFacename sera ajouté ou supprimé de la liste d’exclusions de police.

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

Remarques

La fonction TTEnableEmbeddingForFacename utilise une liste d’exclusions de police de type pour contrôler si une police spécifique peut être incorporée. Cette liste identifie toutes les polices qui ne doivent PAS être incorporées et qui sont partagées par tous les clients de création sur un seul système.

Un client de création peut incorporer des polices sans référencer la liste d’exclusions de police (autrement dit, sans utiliser TTEnableEmbeddingForFacename). L’incorporation de polices dans un document entraîne les compromis suivants.

  • Fournit toutes les informations de police dans un document afin que le client approprié puisse afficher le document.
  • Ajoute la taille à un document.
  • Complique les opérations de lecture et d’écriture en streaming dans un document et utilise plus de bande passante de traitement.
  • Rend un document moins lisible par d’autres applications.
  • Peut laisser les problèmes de copyright non managés, si la liste d’exclusion de type n’est pas utilisée.
Deux fonctions supplémentaires, TTIsEmbeddingEnabled et TTIsEmbeddingEnabledForFacename, accèdent à la liste d’exclusions de police pour fournir des status d’activation.

La liste d’exclusions de police est stockée dans la clé de RegistreHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Shared Tools\t2embed. La liste d’exclusions de police par défaut doit contenir les entrées de valeur nommées suivantes représentant les polices principales Microsoft Windows.

Nom de la valeur Type de données Valeur
Arial REG_DWORD 0
Arial Bold REG_DWORD 0
Arial Bold Italic REG_DWORD 0
Italique arial REG_DWORD 0
Courier New REG_DWORD 0
Courrier nouveau en gras REG_DWORD 0
Courier New Bold Italic REG_DWORD 0
Courier New Italic REG_DWORD 0
Times New Roman REG_DWORD 0
Times New Roman Bold REG_DWORD 0
Times New Roman Bold Italic REG_DWORD 0
Times New Roman Italic REG_DWORD 0

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

TTIsEmbeddingEnabled

TTIsEmbeddingEnabledForFacename