Définition des en-têtes et pieds de page

Les en-têtes et les pieds de page sont les lignes de texte affichées respectivement sous la marge supérieure ou au-dessus de la marge inférieure. Il est également possible d’ajouter des en-têtes et des pieds de page aux feuilles de calcul. Les en-têtes et les pieds de page peuvent être utilisés pour afficher des informations utiles telles que le numéro de page, le nom de l’auteur, le nom du sujet ou la date et l’heure. Les en-têtes et pieds de page sont gérés à l’aide des paramètres de mise en page.

Définition des en-têtes et pieds de page

Aspose.Cells vous permet d’ajouter des en-têtes et des pieds de page aux feuilles de calcul lors de l’exécution, mais nous vous recommandons de définir manuellement les en-têtes et les pieds de page dans un fichier préconçu pour l’impression. Vous pouvez utiliser Microsoft Excel comme outil graphique pour définir des en-têtes et des pieds de page afin d’économiser des efforts et du temps de développement. Aspose.Cells peut importer le fichier et enregistrer les paramètres.

Pour ajouter des en-têtes et des pieds de page lors de l’exécution, Aspose.Cells fournit des appels API spéciaux et des commandes de script pour formater les en-têtes et les pieds de page.

Commandes de script

Les commandes de script sont des commandes spéciales qui vous permettent de définir le formatage de l’en-tête et du pied de page.

Commandes de script	Description
&P	Le numéro de la page actuelle
&G	Une image
&N	Le nombre total de pages
&RÉ	La date actuelle
&T	L’heure actuelle
&UNE	Le nom de la feuille de calcul
&F	Le nom du fichier sans son chemin
&"<FontName>"	Représente un nom de police. Par exemple : &“Arial”
&"<FontName>, <FontStyle>"	Représente le nom de la police avec le style. Par exemple : &“Arial,Gras”
&<FontSize>	Représente la taille de la police. Par exemple : “&14abc”. Mais, si cette commande est suivie d’un nombre en clair à imprimer dans l’en-tête, celui-ci doit être séparé par un espace de la taille de la police. Par exemple : “&14 123”.

Définir les en-têtes et pieds de page

LeMise en page classe fournit deux méthodes,Définir l’en-tête etDéfinir le pied de page, utilisé pour ajouter un en-tête et un pied de page à une feuille de calcul. Ces méthodes ne prennent que deux paramètres :

• Section – la section où l’en-tête ou le pied de page doit être placé. Il y a trois sections : gauche, centre et droite, représentées respectivement par 0, 1 et 2.
• Scénario – le script à utiliser pour l’en-tête ou le pied de page. Ce script contient des commandes de script pour formater les en-têtes ou les pieds de page.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET

// Instantiating a Workbook object
Workbook excel = new Workbook();

// Obtaining the reference of the PageSetup of the worksheet
PageSetup pageSetup = excel.Worksheets[0].PageSetup;

// Setting worksheet name at the left section of the header
pageSetup.SetHeader(0, "&A");

// Setting current date and current time at the centeral section of the header
// and changing the font of the header
pageSetup.SetHeader(1, "&\"Times New Roman,Bold\"&D-&T");

// Setting current file name at the right section of the header and changing the
// font of the header
pageSetup.SetHeader(2, "&\"Times New Roman,Bold\"&12&F");

// Setting a string at the left section of the footer and changing the font
// of a part of this string ("123")
pageSetup.SetFooter(0, "Hello World! &\"Courier New\"&14 123");

// Setting the current page number at the central section of the footer
pageSetup.SetFooter(1, "&P");

// Setting page count at the right section of footer
pageSetup.SetFooter(2, "&N");

// Save the Workbook.
excel.Save("SetHeadersAndFooters_out.xls");

Insérer une image dans un en-tête ou un pied de page

LeMise en page class a deux méthodes supplémentaires,SetHeaderPicture etSetFooterPicture, utilisé pour ajouter des images dans l’en-tête et le pied de page. Ces méthodes prennent les paramètres :

• Section– la section d’en-tête ou de pied de page où l’image sera placée. Il y a trois sections, gauche, centre et droite, représentées respectivement par les valeurs 0, 1 et 2.
• Tableau d’octets – les données graphiques (les données binaires doivent être écrites dans le tampon d’un tableau d’octets).

Après avoir exécuté le code ci-dessous et ouvert le fichier, vérifiez l’en-tête de la feuille de calcul en :

1. Sur leDossier menu, sélectionnezMise en page. Une boîte de dialogue s’affiche.
2. Sélectionnez leEn-tête/Pied de page languette.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Creating a Workbook object
Workbook workbook = new Workbook();

// Creating a string variable to store the url of the logo/picture
string logo_url = dataDir + "aspose-logo.jpg";

// Declaring a FileStream object
FileStream inFile;

// Declaring a byte array
byte[] binaryData;

// Creating the instance of the FileStream object to open the logo/picture in the stream
inFile = new System.IO.FileStream(logo_url, System.IO.FileMode.Open, System.IO.FileAccess.Read);

// Instantiating the byte array of FileStream object's size
binaryData = new Byte[inFile.Length];

// Reads a block of bytes from the stream and writes data in a given buffer of byte array.
long bytesRead = inFile.Read(binaryData, 0, (int)inFile.Length);

// Creating a PageSetup object to get the page settings of the first worksheet of the workbook
PageSetup pageSetup = workbook.Worksheets[0].PageSetup;

// Setting the logo/picture in the central section of the page header
pageSetup.SetHeaderPicture(1, binaryData);

// Setting the script for the logo/picture
pageSetup.SetHeader(1, "&G");

// Setting the Sheet's name in the right section of the page header with the script
pageSetup.SetHeader(2, "&A");

// Saving the workbook
workbook.Save(dataDir + "InsertImageInHeaderFooter_out.xls");

//Closing the FileStream object
inFile.Close();