Kopf- und Fußzeilen einstellen

Kopf- und Fußzeilen sind die Textzeilen, die unter dem oberen Rand bzw. über dem unteren Rand angezeigt werden. Es ist auch möglich, den Arbeitsblättern Kopf- und Fußzeilen hinzuzufügen. Kopf- und Fußzeilen können verwendet werden, um nützliche Informationen wie Seitenzahl, Autorenname, Themenname oder Datum und Uhrzeit anzuzeigen. Kopf- und Fußzeilen werden mithilfe der Seiteneinrichtungseinstellungen verwaltet.

Kopf- und Fußzeilen einstellen

Aspose.Cells ermöglicht Ihnen das Hinzufügen von Kopf- und Fußzeilen zu Arbeitsblättern zur Laufzeit, aber wir empfehlen, Kopf- und Fußzeilen manuell in einer vorgefertigten Datei zum Drucken festzulegen. Sie können Microsoft Excel als GUI-Tool verwenden, um Kopf- und Fußzeilen festzulegen, um Aufwand und Entwicklungszeit zu sparen. Aspose.Cells kann die Datei importieren und die Einstellungen speichern.

Um Kopf- und Fußzeilen zur Laufzeit hinzuzufügen, bietet Aspose.Cells spezielle API-Aufrufe und Skriptbefehle zum Formatieren von Kopf- und Fußzeilen.

Skriptbefehle

Skriptbefehle sind spezielle Befehle, mit denen Sie die Formatierung von Kopf- und Fußzeilen festlegen können.

Skriptbefehle	Beschreibung
&P	Die aktuelle Seitenzahl
&G	Ein Bild
&N	Die Gesamtzahl der Seiten
&D	Das aktuelle Datum
&T	Die aktuelle Zeit
&EIN	Der Arbeitsblattname
&F	Der Dateiname ohne Pfad
&"<FontName>"	Stellt einen Schriftartnamen dar. Zum Beispiel: &“Arial”
&"<FontName>, <FontStyle>"	Stellt den Schriftartnamen mit Stil dar. Zum Beispiel: &“Arial,Bold”
&<FontSize>	Stellt die Schriftgröße dar. Beispiel: „&14abc“. Wenn diesem Befehl jedoch eine einfache Zahl folgt, die in der Kopfzeile gedruckt werden soll, sollte diese mit einem Leerzeichen von der Schriftgröße getrennt werden. Beispiel: „&14 123“.

Legen Sie Kopf- und Fußzeilen fest

DasSeiteneinrichtung Klasse bietet zwei Methoden,SetHeader undSetFooter, wird verwendet, um einem Arbeitsblatt eine Kopf- und Fußzeile hinzuzufügen. Diese Methoden nehmen nur zwei Parameter:

• Abschnitt – der Abschnitt, in dem die Kopf- oder Fußzeile platziert werden soll. Es gibt drei Abschnitte: links, Mitte und rechts, dargestellt durch 0, 1 bzw. 2.
• Skript – das Skript, das für die Kopf- oder Fußzeile verwendet werden soll. Dieses Skript enthält Skriptbefehle zum Formatieren von Kopf- oder Fußzeilen.

// 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");

Fügen Sie ein Bild in eine Kopf- oder Fußzeile ein

DasSeiteneinrichtung Klasse hat zwei zusätzliche Methoden,SetHeaderPicture undSetFooterPicture, wird verwendet, um Bilder in die Kopf- und Fußzeile einzufügen. Diese Methoden nehmen die Parameter:

• Abschnitt– der Kopf- oder Fußzeilenbereich, in dem das Bild platziert wird. Es gibt drei Abschnitte, links, Mitte und rechts, die jeweils durch die Werte 0, 1 und 2 dargestellt werden.
• Byte-Array – die grafischen Daten (die binären Daten sollen in den Puffer eines Byte-Arrays geschrieben werden).

Nachdem Sie den folgenden Code ausgeführt und die Datei geöffnet haben, überprüfen Sie die Kopfzeile des Arbeitsblatts wie folgt:

1. Auf derDatei Menü, auswählenSeiteneinrichtung. Ein Dialogfeld wird angezeigt.
2. Wähle ausKopfzeile Fußzeile Tab.

// 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();