Interface ITextPara (tom.h)

Les attributs de plage de texte enrichi tom (Text Object Model) sont accessibles via une paire d’interfaces doubles, ITextFont et ITextPara.

Héritage

L’interface ITextPara hérite de l’interface IDispatch. ITextPara a également les types de membres suivants :

Méthodes

L’interface ITextPara a ces méthodes.

ITextPara ::AddTab Ajoute un onglet au niveau du déplacement tbPos, avec le type tbAlign, et le style de leader, tbLeader.
ITextPara ::CanChange Détermine si la mise en forme des paragraphes peut être modifiée.
ITextPara ::ClearAllTabs Efface tous les onglets, en rétablissant les onglets également espacés avec l’espacement de tabulation par défaut.
ITextPara ::D eleteTab Supprime un onglet à un déplacement spécifié.
ITextPara ::GetAlignment Récupère la valeur d’alignement de paragraphe actuelle.
ITextPara ::GetDuplicate Crée un doublon de l’objet de format de paragraphe spécifié. La propriété dupliquée est la propriété par défaut d’un objet ITextPara.
ITextPara ::GetFirstLineIndent Récupère la quantité utilisée pour mettre en retrait la première ligne d’un paragraphe par rapport au retrait gauche. Le retrait gauche est le retrait de toutes les lignes du paragraphe, à l’exception de la première ligne.
ITextPara ::GetHyphenation Détermine si la trait d’union automatique est activée pour la plage.
ITextPara ::GetKeepTogether Détermine si les sauts de page sont autorisés dans les paragraphes.
ITextPara ::GetKeepWithNext Détermine si les sauts de page sont autorisés entre les paragraphes de la plage.
ITextPara ::GetLeftIndent Récupère la distance utilisée pour mettre en retrait toutes les lignes à l’exception de la première ligne d’un paragraphe. La distance est relative à la marge gauche.
ITextPara ::GetLineSpacing Récupère la valeur d’espacement de ligne de la plage de texte.
ITextPara ::GetLineSpacingRule Récupère la règle d’espacement de ligne pour la plage de texte.
ITextPara ::GetListAlignment Récupère le type d’alignement à utiliser pour les listes à puces et numérotées.
ITextPara ::GetListLevelIndex Récupère l’index au niveau de la liste utilisé avec les paragraphes.
ITextPara ::GetListStart Récupère la valeur de départ ou le code d’une séquence de numérotation de liste.
ITextPara ::GetListTab Récupère le paramètre d’onglet liste, qui correspond à la distance entre le retrait de première ligne et le texte de la première ligne. Le texte numéroté ou à puces est justifié à gauche, centré ou justifié à droite à la valeur de retrait de la première ligne.
ITextPara ::GetListType Récupère le type de numérotation à utiliser avec les paragraphes.
ITextPara ::GetNoLineNumber Détermine si la numérotation des paragraphes est activée.
ITextPara ::GetPageBreakBefore Détermine si chaque paragraphe de la plage doit commencer sur une nouvelle page.
ITextPara ::GetRightIndent Récupère la taille du retrait de marge droite d’un paragraphe.
ITextPara ::GetSpaceAfter Récupère la quantité d’espace vertical sous un paragraphe.
ITextPara ::GetSpaceBefore Récupère la quantité d’espace vertical au-dessus d’un paragraphe.
ITextPara ::GetStyle Récupère le handle de style pour les paragraphes de la plage spécifiée.
ITextPara ::GetTab Récupère les paramètres d’onglet (déplacement, alignement et style de leader) pour un onglet spécifié.
ITextPara ::GetTabCount Récupère le nombre de tabulations.
ITextPara ::GetWidowControl Récupère l’état de contrôle veuve et orpheline pour les paragraphes d’une plage.
ITextPara ::IsEqual Détermine si la plage actuelle a les mêmes propriétés qu’une plage spécifiée.
ITextPara ::Reset Réinitialise la mise en forme du paragraphe à un choix de valeurs par défaut.
ITextPara ::SetAlignment Définit l’alignement du paragraphe.
ITextPara ::SetDuplicate Définit la mise en forme d’un paragraphe existant en copiant un format donné.
ITextPara ::SetHyphenation Contrôle la coupure pour les paragraphes de la plage.
ITextPara ::SetIndents Définit le retrait de première ligne, le retrait gauche et le retrait droit d’un paragraphe.
ITextPara ::SetKeepTogether Contrôle si les sauts de page sont autorisés dans un paragraphe d’une plage.
ITextPara ::SetKeepWithNext Contrôle si les sauts de page sont autorisés entre les paragraphes d’une plage.
ITextPara ::SetLineSpacing Définit la règle d’espacement des lignes de paragraphe et l’espacement de ligne d’un paragraphe.
ITextPara ::SetListAlignment Définit l’alignement du texte à puces ou numéroté utilisé pour les paragraphes.
ITextPara ::SetListLevelIndex Définit l’index de niveau liste utilisé pour les paragraphes.
ITextPara ::SetListStart Définit le nombre de départ ou la valeur Unicode d’une liste numérotée.
ITextPara ::SetListTab Définit le paramètre d’onglet de liste, qui correspond à la distance entre le premier retrait et le début du texte sur la première ligne.
ITextPara ::SetListType Définit le type de liste à utiliser pour les paragraphes.
ITextPara ::SetNoLineNumber Détermine s’il faut supprimer la numérotation des paragraphes dans une plage.
ITextPara ::SetPageBreakBefore Contrôle s’il y a un saut de page avant chaque paragraphe d’une plage.
ITextPara ::SetRightIndent Définit la marge droite du paragraphe.
ITextPara ::SetSpaceAfter Définit la quantité d’espace qui suit un paragraphe.
ITextPara ::SetSpaceBefore Définit la quantité d’espace précédant un paragraphe.
ITextPara ::SetStyle Définit le style de paragraphe pour les paragraphes d’une plage.
ITextPara ::SetWidowControl Contrôle la suppression des veuves et des orphelins.

Remarques

Les interfaces ITextFont et ITextPara encapsulent les fonctionnalités des boîtes de dialogue Microsoft Word Mettre en forme la police et le paragraphe, respectivement. Les deux interfaces incluent une propriété en double (Value) qui peut retourner un doublon des attributs d’un objet de plage ou transférer un ensemble d’attributs vers une plage. En tant que tels, ils agissent comme des peintres de format programmable. Par exemple, vous pouvez transférer tous les attributs de la plage r1 à la plage r2, à l’exception de la mise en gras r2 et de la taille de police 12 points à l’aide de la sous-routine suivante.

Sub AttributeCopy(r1 As ITextRange, r2 As ITextRange)
    Dim tf As ITextFont
    tf = r1.Font                ' Value is the default property    
    tf.Bold = tomTrue           ' You can make some modifications
    tf.Size = 12
    tf.Animation = tomSparkleText
    r2.Font = tf                ' Apply font attributes all at once
End Sub

Consultez SetFont pour obtenir un exemple similaire écrit en C++.

L’interface ITextPara encapsule la boîte de dialogue Paragraphe Word. Toutes les mesures sont données en points à virgule flottante. Le contrôle d’édition enrichie est en mesure d’accepter et de renvoyer toutes les propriétés ITextPara intactes (c’est-à-dire sans modification), à la fois par le biais de TOM et de ses convertisseurs RTF (Rich Text Format). Toutefois, les propriétés suivantes n’ont aucun effet sur ce que le contrôle affiche :

• DoNotHyphen
• KeepTogether
• KeepWithNext
• Interligne
• LineSpacingRule
• NoLineNumber
• PageBreakBefore
• Alignements des onglets
• Styles tabulation (autres que tomAlignLeft et tomSpaces)
• Style WidowControl

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

Voir aussi

Conceptuel

IDispatch

Modèle objet texte

Utilisation du modèle objet texte