Travailler avec les en-têtes et les pieds de page
Aspose.Words permet aux utilisateurs de travailler avec les en-têtes et les pieds de page d’un document. Un en-tête est un texte placé en haut d’une page et un pied de page est un texte placé en bas d’une page. Généralement, ces zones sont utilisées pour insérer des informations qui doivent être répétées sur toutes ou certaines pages du document, telles que les numéros de page, la date de création, les informations sur l’entreprise, etc.
Créer des en-têtes ou des pieds de page à l’aide de DocumentBuilder
Si vous souhaitez ajouter un en-tête ou un pied de page de document par programmation, le moyen le plus simple consiste à utiliser la classe DocumentBuilder pour le faire.
L’exemple de code suivant montre comment ajouter un en-tête et un pied de page pour les pages du document:
Spécifier les options d’en-tête ou de pied de page
Lorsque vous ajoutez un en-tête ou un pied de page à un document, vous pouvez définir certaines propriétés avancées. Aspose.Words fournit aux utilisateurs les classes HeaderFooter et HeaderFooterCollection, ainsi qu’une énumération HeaderFooterType qui vous donnent plus de contrôle sur le processus de personnalisation des en-têtes et des pieds de page.
Spécifier le type d’en-tête ou de pied de page
Vous pouvez spécifier trois types d’en-tête différents et trois types de pied de page différents pour un document:
- En-tête et/ou pied de page de la première page
- En-tête et/ou pied de page pour les pages paires
- En-tête et/ou pied de page pour les pages impaires
L’exemple de code suivant montre comment ajouter un en-tête pour les pages impaires d’un document:
Spécifier s’il faut afficher différents en-têtes ou pieds de page pour la première page
Comme indiqué ci-dessus, vous pouvez également définir un en-tête ou un pied de page différent pour la première page. Pour ce faire, vous devez définir l’indicateur different_first_page_header_footer sur true
, puis spécifier la valeur HeaderFirst ou FooterFirst.
L’exemple de code suivant montre comment définir l’en-tête de la première page uniquement:
Spécifier s’il faut afficher différents en-têtes ou pieds de page pour les pages impaires ou paires
Ensuite, vous souhaiterez définir différents en-têtes ou pieds de page pour les pages paires et impaires d’un document. Pour ce faire, vous devez définir l’indicateur odd_and_even_pages_header_footer sur true
puis spécifier les valeurs HeaderPrimary et HeaderEven, ou FooterPrimary et FooterEven.
Insérer une image absolument positionnée dans l’en-tête
Pour placer une image dans un en-tête ou un pied de page, utilisez le type d’en-tête HeaderPrimary ou le type de pied de page FooterPrimary et la méthode insert_image.
L’exemple de code suivant montre comment ajouter une image à un en-tête:
Définir les propriétés de police et de paragraphe pour le texte d’en-tête ou de pied de page
Avec Aspose.Words, vous pouvez définir les propriétés de police et de paragraphe, utiliser le type d’en-tête HeaderPrimary ou le type de pied de page FooterPrimary, ainsi que les méthodes et propriétés permettant de travailler avec les polices et les paragraphes que vous utilisez pour le corps du document.
L’exemple de code suivant montre comment définir le texte de l’en-tête sur Arial, gras, taille 14 et alignement central:
Insérer des numéros de page dans l’en-tête ou le pied de page
Si nécessaire, vous pouvez ajouter des numéros de page à l’en-tête ou au pied de page. Pour ce faire, utilisez le type d’en-tête HeaderPrimary ou le type de pied de page FooterPrimary et la méthode insert_field pour ajouter le champ obligatoire.
L’exemple de code suivant montre comment ajouter des numéros de page au pied de page de droite:
Utiliser les en-têtes ou les pieds de page définis dans la section précédente
Si vous devez copier l’en-tête ou le pied de page de la section précédente, vous pouvez également le faire.
L’exemple de code suivant montre comment copier l’en-tête ou le pied de page de la section précédente:
Assurez l’apparence de l’en-tête ou du pied de page lors de l’utilisation de différentes orientations et tailles de page
Aspose.Words vous permet de donner l’apparence d’un en-tête ou d’un pied de page lorsque vous utilisez différentes orientations et tailles de page.
L’exemple suivant montre comment procéder:
Comment supprimer uniquement les en-têtes ou uniquement les pieds de page
Chaque section d’un document peut comporter jusqu’à trois en-têtes et jusqu’à trois pieds de page (pour les premières pages, paires et impaires). Si vous souhaitez supprimer tous les en-têtes ou tous les pieds de page d’un document, vous devez parcourir toutes les sections et supprimer chaque nœud d’en-tête ou de pied de page correspondant.
L’exemple de code suivant montre comment supprimer tous les pieds de page de toutes les sections tout en laissant les en-têtes intacts. Vous pouvez supprimer uniquement les en-têtes de la même manière: