Partager via


Méthode ITextRange ::SetFont (tom.h)

Définit les attributs de caractères de cette plage sur ceux de l’objet ITextFont spécifié.

Syntaxe

HRESULT SetFont(
  [in] ITextFont *pFont
);

Paramètres

[in] pFont

Type : ITextFont*

Objet de police avec le format de caractère souhaité.

Valeur retournée

Type : HRESULT

La méthode retourne une valeur HRESULT . Si la méthode réussit, elle retourne S_OK. Si la méthode échoue, elle retourne l’un des codes d’erreur suivants. Pour plus d’informations sur les codes d’erreur COM, consultez Gestion des erreurs dans COM.

Code de retour Description
Valeur
Signification
E_ACCESSDENIED
Le texte est protégé.
E_INVALIDARG
pFont a la valeur null.
E_OUTOFMEMORY
Mémoire insuffisante.

Remarques

Pour les modifications de format occasionnelles, utilisez la méthode ITextRange ::SetFont . Toutefois, pour apporter un certain nombre de modifications à la mise en forme des caractères, il est plus efficace d’utiliser un doublon de police. En effet, chaque fois que vous exécutez une instruction comme range.font.bold = tomTrue, un objet de police est alloué et libéré. Toutefois, un doublon de police peut être alloué une seule fois et utilisé plusieurs fois. En outre, vous pouvez enregistrer le doublon de police, le rétablir à l’état par défaut ou non défini avec la méthode Reset et lui donner les valeurs nécessaires pour votre traitement de texte enrichi. Pour obtenir un exemple de code qui montre comment utiliser des doublons de polices, consultez Utilisation d’un doublon de police.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête tom.h
DLL Msftedit.dll

Voir aussi

Conceptuel

ITextRange

Référence

Réinitialiser

Modèle objet texte