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

Article
03/06/2024

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