Travail avec les paragraphes
Un paragraphe est un ensemble de caractères combinés dans un bloc logique et se terminant par un caractère spécial – une pause paragraphe. En Aspose.Words, un paragraphe est représenté par Paragraph En cours.
Insérer un paragraphe
Pour insérer un nouveau paragraphe dans le document, en fait, vous devez y insérer un caractère de rupture de paragraphe. DocumentBuilder.Writeln insère non seulement une chaîne de texte dans le document, mais ajoute également une pause de paragraphe.
Le formatage actuel de la police est également spécifié par le Font la propriété, et le formatage actuel du paragraphe est déterminé par le ParagraphFormat propriété. Dans la prochaine section, nous aborderons plus en détail le formatage des paragraphes.
L’exemple de code suivant montre comment insérer un paragraphe dans un document:
Format du paragraphe
Le formatage actuel des paragraphes est représenté par ParagraphFormat objet retourné par le ParagraphFormat propriété. Cet objet encapsule diverses propriétés de formatage de paragraphe disponibles dans Microsoft Word. Vous pouvez facilement réinitialiser le formatage d’un paragraphe à sa valeur par défaut – Style normal, aligné à gauche, sans indentation, sans espacement, sans bordures, sans ombre – en appelant ClearFormatting.
L’exemple de code suivant montre comment définir le formatage des paragraphes:
Appliquer le style de paragraphe
Certains objets de formatage comme les styles de support Font ou ParagraphFormat. Un style intégré ou défini par l’utilisateur est représenté par un Style objet qui contient les propriétés de style correspondantes comme nom, style de base, police et formatage de paragraphe du style, et ainsi de suite.
En outre, Style objet fournit la StyleIdentifier propriété qui retourne un identifiant de style indépendant local représenté par un StyleIdentifier valeur de dénombrement. Le point est que les noms des styles intégrés dans Microsoft Word sont localisés pour différentes langues. En utilisant un identifiant de style, vous pouvez trouver le style correct quel que soit le langage du document. Les valeurs de dénombrement correspondent à la Microsoft Word styles intégrés tels que Normal, * cap 1*, * cap 2*, etc. Tous les styles définis par l’utilisateur sont assignés **StyleIdentificateur. Valeur utilisateur**.
L’exemple de code suivant montre comment appliquer un style de paragraphe:
Insérer le séparateur de style pour mettre différents styles de paragraphe
Le séparateur de style peut être ajouté à la fin d’un paragraphe en utilisant le raccourci clavier Ctrl + Alt + Entrée dans MS Word. Cette fonctionnalité permet deux styles de paragraphe différents utilisés dans un paragraphe imprimé logique. Si vous voulez que le texte du début d’un titre apparaisse dans une table des matières, mais que vous ne voulez pas que le titre entier figure 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 tenir compte de différents styles de paragraphe:
Appliquer les frontières et l’ombre à un paragraphe
Les frontières Aspose.Words sont représentés par les BorderCollection classe – c’est une collection de Border objets accessibles par index ou par type de bordure. Les Border type est représenté par le BorderType Énumération. Certaines valeurs du dénombrement s’appliquent à plusieurs ou à un seul élément de document. Par exemple, BorderType.Bottom est applicable à un paragraphe ou à une cellule de tableau pendant BorderType.DiagonalDown spécifie la bordure diagonale dans une cellule de table seulement.
La collection de bordures et chaque bordure séparée ont des attributs similaires comme la couleur, le style de ligne, la largeur de ligne, la distance du texte et l’ombre optionnelle. Ils sont représentés par des propriétés du même nom. Vous pouvez obtenir différents types de bordure en combinant les valeurs de propriété. En outre, les deux BorderCollection et Border objets vous permettent de réinitialiser ces valeurs par défaut en appelant le ClearFormatting méthode.
Aspose.Words a également Shading classe contient des attributs d’ombrage pour les éléments de document. Vous pouvez définir la texture d’ombrage souhaitée et les couleurs qui sont appliquées au fond et au premier plan de l’élément.
La texture d’ombrage est définie avec la TextureIndex valeur de dénombrement qui permet l’application de différents modèles à la Shading objet. Par exemple, pour définir une couleur de fond pour un élément de document, utilisez le TextureIndex.TextureSolid valeur et définir la couleur d’ombrage avant plan selon le cas. L’exemple de code ci-dessous montre comment appliquer les bordures et l’ombrage à un paragraphe.
L’exemple de code suivant montre comment appliquer les frontières et l’ombrage à un paragraphe: