Travailler avec des paragraphes
Un paragraphe est un ensemble de caractères combinés en un bloc logique et se terminant par un caractère spécial – un saut de paragraphe. Dans Aspose.Words, un paragraphe est représenté par la classe Paragraph.
Insérer un paragraphe
Pour insérer un nouveau paragraphe dans le document, en effet, vous devez y insérer un caractère de saut de paragraphe. DocumentBuilder.writeln insère également une chaîne de texte dans le document, mais en plus, il ajoute un saut de paragraphe.
Le formatage actuel de la police est également spécifié par la propriété font et le formatage actuel du paragraphe est déterminé par la propriété paragraph_format.
L’exemple de code suivant montre comment insérer un paragraphe dans un document:
Formater le paragraphe
Le formatage actuel du paragraphe est représenté par un objet ParagraphFormat renvoyé par la propriété paragraph_format. Cet objet encapsule diverses propriétés de formatage de paragraphe disponibles en Microsoft Word. Vous pouvez facilement réinitialiser le formatage du paragraphe par défaut sur le style Normal, aligné à gauche, sans indentation, sans espacement, sans bordures et sans ombrage en appelant clear_formatting.
L’exemple de code suivant montre comment définir la mise en forme des paragraphes:
Appliquer un style de paragraphe
Certains objets de formatage comme les styles de support Font ou ParagraphFormat. Un style unique intégré ou défini par l’utilisateur est représenté par un objet Style qui contient les propriétés de style correspondantes telles que le nom, le style de base, la mise en forme de la police et du paragraphe du style, etc.
De plus, un objet Style fournit la propriété Style.style_identifier qui renvoie un identifiant de style indépendant des paramètres régionaux représenté par une valeur d’énumération StyleIdentifier. Le fait est que les noms des styles intégrés dans Microsoft Word sont localisés pour différentes langues. À l’aide d’un identifiant de style, vous pouvez trouver le style correct quelle que soit la langue du document. Les valeurs d’énumération correspondent aux styles intégrés Microsoft Word tels que Normal, Heading 1, Heading 2 etc. Tous les styles définis par l’utilisateur se voient attribuer la valeur StyleIdentifier.USER
L’exemple de code suivant montre comment appliquer un style de paragraphe:
Insérer un séparateur de style pour mettre différents styles de paragraphe
Un séparateur de style peut être ajouté à la fin d’un paragraphe à l’aide du raccourci clavier Ctrl + Alt + Entrée dans MS Word. Cette fonctionnalité permet d’utiliser deux styles de paragraphe différents dans un seul paragraphe imprimé logique. Si vous souhaitez qu’un texte du début d’un titre particulier apparaisse dans une table des matières mais que vous ne souhaitez pas que l’intégralité du titre soit affichée dans la table des matières, vous pouvez utiliser cette fonctionnalité
L’exemple de code suivant montre comment insérer un séparateur de style pour s’adapter à différents styles de paragraphe:
Identifier le séparateur de style de paragraphe
Aspose.Words fournit une propriété publique break_is_style_separator dans une classe Paragraph permettant d’identifier le paragraphe séparateur de style comme le montre l’exemple ci-dessous:
Appliquer des bordures et un ombrage à un paragraphe
Les frontières sont représentées par le BorderCollection. Il s’agit d’une collection d’objets Border accessibles par index ou par type de bordure. Le type de bordure est représenté par l’énumération BorderType. Certaines valeurs de l’énumération sont applicables à plusieurs ou à un seul élément du document. Par exemple, BorderType.BOTTOM s’applique à un paragraphe ou à une cellule de tableau tandis que BorderType.DIAGONALDOWN spécifie la bordure diagonale dans une cellule de tableau uniquement.
La collection de bordures et chaque bordure distincte ont des attributs similaires tels que la couleur, le style de ligne, la largeur de ligne, la distance par rapport au texte et l’ombre facultative. Ils sont représentés par des propriétés du même nom. Vous pouvez obtenir différents types de bordures en combinant les valeurs des propriétés. De plus, les objets BorderCollection et Border vous permettent de réinitialiser ces valeurs par défaut en appelant la méthode Border.clear_formatting.
Aspose.Words possède également la classe Shading qui contient des attributs d’ombrage pour les éléments du document. Vous pouvez définir la texture d’ombrage souhaitée et les couleurs appliquées à l’arrière-plan et au premier plan de l’élément.
La texture d’ombrage est définie avec une valeur d’énumération TextureIndex qui permet l’application de divers modèles à l’objet Shading. Par exemple, pour définir une couleur d’arrière-plan pour un élément de document, utilisez la valeur TextureIndex.TEXTURE_SOLID et définissez la couleur d’ombrage de premier plan de manière appropriée. L’exemple ci-dessous montre comment appliquer des bordures et un ombrage à un paragraphe.
L’exemple de code suivant montre comment appliquer des bordures et un ombrage à un paragraphe: