Comment travailler avec les sections dans .NET

Étape 1: Installer le package

Aspose.Words FOSS for .NET ne publie pas encore de package NuGet — construisez la bibliothèque à partir des sources à la place. Clonez https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git, puis compilez Aspose.Words.sln en configuration Release avec le SDK .NET et référencez l’assembly Aspose.Words résultant depuis votre projet. La bibliothèque cible .NET Standard 2.0, elle s’exécute donc sur le Framework .NET 4.6.2+ et .NET 6/8/10.

Étape 2: Importer les classes requises

Ajoutez une directive using Aspose.Words; — Section, PageSetup, HeaderFooter, et les énumérations associées utilisées dans ce guide se trouvent directement dans l’espace de noms Aspose.Words aux côtés de Document et DocumentBuilder.

Étape 3 : Lire les sections déjà présentes dans un document

Document.Sections renvoie un SectionCollection contenant chaque Section du document, chacun étant un CompositeNode qui fait également partie de l’arbre de nœuds global. Document.FirstSection et Document.LastSection donnent un accès direct aux sections limites sans parcourir la collection. Chaque Section contient un Body – atteint de la même manière que tout autre Story – et, lorsqu’il est présent, le contenu d’en-tête et de pied de page accessible via Section.HeadersFooters.

Étape 4 : Démarrer une nouvelle section avec un saut de section

Call DocumentBuilder.InsertBreak(BreakType) à l’endroit du curseur pour démarrer une nouvelle section. Pass BreakType.SectionBreakNewPage lorsque la nouvelle section doit toujours commencer sur une nouvelle page, BreakType.SectionBreakContinuous lorsque seul un changement de configuration de page est nécessaire (par exemple, passer à du texte multi-colonnes) sans imposer de saut de page, ou BreakType.SectionBreakNewColumn, SectionBreakEvenPage, et SectionBreakOddPage pour les autres comportements de démarrage de section que Word prend en charge. Un saut de section conserve le formatage pour la section qui follows elle, donc définissez PageSetup propriétés sur le nouveau Section – pas celle qui le précède – une fois le saut inséré. DocumentBuilder.MoveToSection(sectionIndex) déplace le curseur au début du corps d’une section spécifique, et PageSetup.SectionStart lit ou définit le SectionStart type de saut déjà enregistré sur une section existante.

Étape 5 : Configurer les dimensions de page et les marges

Chaque Section.PageSetup est une instance PageSetup. Définissez PageWidth, PageHeight, LeftMargin, RightMargin, TopMargin, BottomMargin et Gutter pour les dimensions de page et les marges, ou attribuez un préréglage Margins directement à PageSetup.Margins. Orientation et PaperSize contrôlent l’orientation de la page et le format du papier. Les bordures de page sont configurées avec Borders (un BorderCollection), BorderAppliesTo (PageBorderAppliesTo), BorderDistanceFrom (PageBorderDistanceFrom), BorderAlwaysInFront, BorderSurroundsHeader et BorderSurroundsFooter. Appelez PageSetup.ClearFormatting() pour réinitialiser la configuration de page d’une section aux valeurs par défaut avant de la configurer à partir de zéro.

Étape 6 : Ajouter et lier les en-têtes et pieds de page

Section.HeadersFooters est un HeaderFooterCollection avec des accesseurs typés – HeaderPrimary, HeaderFirst, HeaderEven, FooterPrimary, FooterFirst, FooterEven – ainsi que GetByHeaderFooterType() pour la recherche par HeaderFooterType et Add() afin d’en ajouter un nouveau. Chaque HeaderFooter est un Story, signalé IsHeader et IsLinkedToPrevious. Activez PageSetup.DifferentFirstPageHeaderFooter ou PageSetup.OddAndEvenPagesHeaderFooter avant d’ajouter la variante correspondante HeaderFirst/FooterFirst ou HeaderEven/FooterEven — le drapeau et la variante ne prennent effet qu’ensemble. Appelez HeaderFooterCollection.LinkToPrevious() pour reconnecter l’en-tête ou le pied de page d’une section afin d’hériter du contenu de la section précédente, ou pour le détacher afin que la nouvelle section commence avec un contenu indépendant.

Étape 7: Disposer le texte du corps en plusieurs colonnes

PageSetup.TextColumns renvoie un TextColumnCollection pour la section. Appelez SetCount() avec le nombre de colonnes dans lesquelles le texte du corps doit s’écouler, puis ajustez EvenlySpaced, Spacing, LineBetween et Width pour contrôler la disposition des colonnes. Une fois que la collection comporte plus d’une colonne, les instances individuelles de TextColumn exposent leurs propres Width et SpaceAfter.

Étape 8: Effacer ou modifier en masse le contenu de la section

Section.AppendContent() et PrependContent() copient le contenu du corps d’une autre section dans celle-ci; ClearContent() vide le corps d’une section en masse. ClearHeadersFooters() et DeleteHeaderFooterShapes() effacent le contenu de l’en-tête et du pied de page dans toute la section sans supprimer la section elle-même.