Travailler avec les sections
Parfois, vous voulez un document qui n’a pas le même formatage sur toutes les pages. Par exemple, vous devrez peut-être modifier le format des numéros de page, avoir une taille et une orientation différentes, ou avoir la première page de document comme page couverture sans numérotation. Vous pouvez y parvenir avec des sections.
Les sections sont des nœuds de niveau qui contrôlent les en-têtes et les pied de page, l’orientation, les colonnes, les marges, le formatage des numéros de page, et d’autres.
Aspose.Words vous permet de gérer les sections, de diviser un document en sections et d’effectuer des modifications de formatage qui ne s’appliquent qu’à une section donnée. Aspose.Words stocke des informations sur le formatage de section telles que les en-têtes et les pied de page, la configuration de page et les paramètres de colonne dans la pause section.
Cet article explique comment travailler avec les sections et les pauses.
Ce qu’est la section et la section
Les sections des documents sont représentées par Section et SectionCollection les cours. Les objets de section sont des enfants immédiats de Document noeud et peut être consulté via le Sections propriété. Vous pouvez gérer ces nœuds en utilisant certaines méthodes telles que Remove, Add, IndexOf, et d’autres.
Section break est une option qui divise les pages de document en sections avec des mises en page personnalisables.
Types de pause de section
Aspose.Words vous permet de diviser et de formater les documents en utilisant différentes sections BreakType énumération:
- SectionBreakContinu
- SectionBreakNewColumn
- SectionBreakNouvellePage
- SectionBreakEvenPage
- SectionBreakOddPage
Vous pouvez également utiliser le SectionStart énumération pour choisir un type de pause qui s’applique uniquement à la première section comme NewColumn, NewPage, EvenPage et OddPage.
Gérer une section
Comme une section est un noeud composite normal, toute la manipulation du noeud API peut être utilisé pour manipuler des sections: ajouter, supprimer et d’autres opérations sur des sections. Vous pouvez en savoir plus sur les nœuds dans l’article Aspose.Words Document Object Model (DOM).
D’autre part, vous pouvez également utiliser le DocumentBuilder API travailler avec les sections. Dans cet article, nous nous concentrerons sur cette façon particulière de travailler avec les sections.
Insérer ou supprimer une pause section
Aspose.Words vous permet d’insérer une section dans le texte en utilisant InsertBreak méthode.
L’exemple de code suivant montre comment insérer une section dans un document:
Utiliser Remove méthode pour supprimer une rupture de section. Si vous n’avez pas besoin de supprimer une pause de section spécifique et plutôt supprimer le contenu de cette section, vous pouvez utiliser le ClearContent méthode.
L’exemple de code suivant montre comment supprimer les cassures de sections:
Déplacer une section
Si vous voulez déplacer une section d’une position à une autre dans votre document, vous devez obtenir l’index de cette section. Aspose.Words vous permet d’obtenir une position de section SectionCollection. Vous pouvez utiliser le Sections propriété pour obtenir toutes les sections de votre document. Mais si vous voulez obtenir seulement la première section, vous pouvez utiliser le FirstSection propriété.
L’exemple de code suivant montre comment accéder à la première section et itérer à travers les enfants d’un noeud composite:
Spécifier une disposition de section
Parfois, vous voulez que votre document soit plus beau en faisant des mises en page créatives pour différentes sections de documents. Si vous voulez spécifier le type de la grille de section actuelle, vous pouvez choisir un mode de mise en page de section en utilisant le SectionLayoutMode énumération:
- Par défaut
- Grille
- LigneGrid
- Enfilez-les à Chars
L’exemple de code suivant montre comment limiter le nombre de lignes que chaque page peut avoir:
Modifier une section
Lorsque vous ajoutez une nouvelle section à votre document, il n’y aura pas de corps ou de paragraphe que vous pouvez modifier. Aspose.Words vous permet de garantir qu’une section contient un corps avec au moins un paragraphe EnsureMinimum méthode – elle ajoutera automatiquement un nœud Corps (ou HeaderFooter) au document, puis y ajoutera un paragraphe.
L’exemple de code suivant montre comment préparer un nouveau nœud de section en utilisant EnsureMinimum:
Ajouter ou prépendre du contenu
Si vous voulez dessiner une forme ou ajouter du texte ou une image au début/à la fin d’une section, vous pouvez utiliser la AppendContent et PrependContent les méthodes de Section En cours.
L’exemple de code suivant montre comment ajouter le contenu d’une section existante:
Clone une section
Aspose.Words vous permet de dupliquer une section en créant une copie complète de celle-ci en utilisant deepClone méthode.
L’exemple de code suivant montre comment cloner la première section de votre document:
Copier les sections entre les documents
Dans certains cas, vous pouvez avoir de grands documents avec de nombreuses sections et vous voulez copier le contenu d’une section d’un document à l’autre.
Aspose.Words vous permet de copier des sections entre les documents en utilisant ImportNode méthode.
L’exemple de code suivant montre comment copier les sections entre les documents:
Travailler avec l’en-tête de section et le pied de page
Les règles de base pour afficher un en-tête ou un pied de page pour chaque section sont assez simples:
- Si la section n’a pas ses propres en-têtes/pieds d’un certain type, elle est reprise de la section précédente.
- Le type d’en-tête/footer affiché sur la page est contrôlé par les paramètres de la section “Différent Première Page” et “Différente Odd & Even pages” – s’ils sont désactivés, alors les titres de la section sont ignorés.
L’exemple de code suivant montre comment créer 2 sections avec différents en-têtes:
Si vous voulez supprimer le texte des en-têtes et des pieds de page sans supprimer HeaderFooter objets dans votre document, vous pouvez utiliser ClearHeadersFooters méthode. En outre, vous pouvez utiliser le DeleteHeaderFooterShapes méthode pour enlever toutes les formes des en-têtes et des pied de page dans votre document.
L’exemple de code suivant montre comment effacer le contenu de tous les en-têtes et les pied de page dans une section:
L’exemple de code suivant comment supprimer toutes les formes de tous les pieds de page en-têtes dans une section:
Personnaliser les propriétés de la page dans une section
Avant d’imprimer une page ou un document, vous pouvez personnaliser et modifier la taille et la mise en page d’une seule page ou de l’ensemble du document. Avec la configuration des pages, vous pouvez modifier les paramètres des pages de documents tels que les marges, l’orientation et la taille pour imprimer différentes premières pages ou pages impaires.
Aspose.Words vous permet de personnaliser les propriétés de la page et de la section PageSetup En cours.
L’exemple de code suivant montre comment définir des propriétés telles que la taille et l’orientation de la page pour la section actuelle:
L’exemple de code suivant montre comment modifier les propriétés de la page dans toutes les sections: