Η κεφαλίδα είναι μια ενότητα του εγγράφου που εμφανίζεται στο επάνω περιθώριο και γενικά περιέχει πληροφορίες όπως ο αριθμός σελίδας, η ημερομηνία και το όνομα του εγγράφου. Με το ASPose.Words REST API μπορείτε να εισαγάγετε αριθμό σελίδας στο έγγραφο του Word καθώς και κεφαλίδες σελίδας. Από προεπιλογή, οι κεφαλίδες είναι ίδιες σε κάθε σελίδα, αλλά μπορούμε να δημιουργήσουμε διαφορετικές κεφαλίδες για μονές και ζυγές σελίδες.

Αυτή η ανάρτηση στοχεύει στην επίτευξη της ακόλουθης διάταξης του εγγράφου, στην οποία η κεφαλίδα στην πρώτη σελίδα είναι διαφορετική από τις υπόλοιπες σελίδες:

Εισαγάγετε τον αριθμό σελίδας
Εισαγωγή κεφαλίδας

Πριν καλέσουμε οποιοδήποτε Aspose REST API, πρέπει να δημιουργήσουμε Aspose Cloud account και να αποκτήσουμε το κλειδί εφαρμογής και το αναγνωριστικό εφαρμογής. Το άρθρο Ξεκινώντας εξηγεί πώς να εκτελέσετε αυτά τα βήματα.

Επιπλέον, πρέπει να ανεβάσουμε το δείγμα του εγγράφου στο Cloud Storage καθώς όλες οι λειτουργίες στο έγγραφο θα εκτελούνται στο Cloud:

// Για ένα πλήρες παράδειγμα και αρχείο δεδομένων, μεταβείτε στη διεύθυνση https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/Examples/Aspose.Words.Cloud.Sdk.Examples/HeaderFooter /InsertHeadersAndPageNumbersToAWordDocument.cs

string MyAppKey = ""; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = ""; // Get AppKey and AppSID from https://dashboard.aspose.cloud/

StorageApi storageApi = new StorageApi(MyAppKey, MyAppSid);

string fileName = "Sample-Document.docx";

// Μεταφορτώστε το έγγραφο προέλευσης στο Cloud Storage
PutCreateRequest request = new PutCreateRequest(fileName, File.OpenRead(@"c:\Data\" + fileName), null, null);
storageApi.PutCreate(request);

Εισαγωγή κεφαλίδας σε έγγραφο του Word

Insert Header Footer Το API προσθέτει κεφαλίδες σε ένα έγγραφο και η παράμετρος headerFooterType μπορεί να λάβει μία από τις ακόλουθες έξι τιμές:

  • HeaderFirst - Κεφαλίδα για την πρώτη σελίδα της ενότητας.
  • HeaderPrimary - Κύρια κεφαλίδα, που χρησιμοποιείται επίσης για σελίδες με περιττούς αριθμούς.
  • HeaderEven - Κεφαλίδα για ζυγές σελίδες.
  • FooterFirst - Υποσέλιδο για την πρώτη σελίδα της ενότητας.
  • FooterPrimary - Κύριο υποσέλιδο, που χρησιμοποιείται επίσης για σελίδες με μονούς αριθμούς.
  • FooterEven - Υποσέλιδο για ζυγές σελίδες.

Χρησιμοποιήστε την τιμή HeaderFirst για να εισαγάγετε την κεφαλίδα στην πρώτη σελίδα:

// Για ένα πλήρες παράδειγμα και αρχείο δεδομένων, μεταβείτε στη διεύθυνση https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/Examples/Aspose.Words.Cloud.Sdk.Examples/HeaderFooter /InsertHeadersAndPageNumbersToAWordDocument.cs

string MyAppKey = ""; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = ""; // Get AppKey and AppSID from https://dashboard.aspose.cloud/

WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);

string fileName = "Sample-Document.docx";
string folder = null; // File exists at the root of the storage

// Εισαγωγή κεφαλίδας για την πρώτη σελίδα
var putHeaderFooterRequest = new PutHeaderFooterRequest(fileName, "HeaderFirst", folder);
var actual = wordsApi.PutHeaderFooter(putHeaderFooterRequest);

και HeaderPrimary τιμή για να εισαγάγετε την κεφαλίδα στις υπόλοιπες σελίδες:

// Για ένα πλήρες παράδειγμα και αρχείο δεδομένων, μεταβείτε στη διεύθυνση https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/Examples/Aspose.Words.Cloud.Sdk.Examples/HeaderFooter /InsertHeadersAndPageNumbersToAWordDocument.cs

// Εισαγωγή κεφαλίδας για όλες τις άλλες σελίδες
var putHeaderFooterRequest = new PutHeaderFooterRequest(fileName, "HeaderPrimary", folder);
var actual = wordsApi.PutHeaderFooter(putHeaderFooterRequest);

Εφόσον η πρώτη κεφαλίδα είναι διαφορετική από τις άλλες, ορίστε την τιμή της παραμέτρου DifferentFirstPageHeaderFooter σε true όπως φαίνεται παρακάτω:

// Για ένα πλήρες παράδειγμα και αρχείο δεδομένων, μεταβείτε στη διεύθυνση https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/Examples/Aspose.Words.Cloud.Sdk.Examples/HeaderFooter /InsertHeadersAndPageNumbersToAWordDocument.cs

var sectionIndex = 0;
var body = new PageSetup
{
    DifferentFirstPageHeaderFooter = true
};

var pageSetupRequest = new UpdateSectionPageSetupRequest(fileName, sectionIndex, body);
var actual = wordsApi.UpdateSectionPageSetup(pageSetupRequest);

Μετά την εκτέλεση του παραπάνω αποσπάσματος κώδικα, έχουν προστεθεί κενές παράγραφοι στις κεφαλίδες του εγγράφου. Τώρα, για να προσθέσουμε κείμενο σε αυτές τις κεφαλίδες, θα χρησιμοποιήσουμε το Insert Paragraph API. Ο κώδικας που εμφανίζεται παρακάτω προσθέτει κείμενο “Aspose” στην πρώτη κεφαλίδα και κείμενο “Cloud File Format API” σε όλες τις άλλες κεφαλίδες:

// Για ένα πλήρες παράδειγμα και αρχείο δεδομένων, μεταβείτε στη διεύθυνση https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/Examples/Aspose.Words.Cloud.Sdk.Examples/HeaderFooter /InsertHeadersAndPageNumbersToAWordDocument.cs

var run = new Run { Text = "ASPOSE" };
            
var runRequest = new PutRunRequest(fileName, "sections/0/headersfooters/1/paragraphs/0", run);
var actual = wordsApi.PutRun(runRequest);

Εφαρμογή μορφοποίησης σε κείμενο κεφαλίδας

Η μορφοποίηση μπορεί να εφαρμοστεί στο κείμενο μιας κεφαλίδας χρησιμοποιώντας το API Update Run Font. Το API δέχεται αντικείμενο fontDto στο σώμα του, του οποίου οι λεπτομέρειες των Ιδιοτήτων πόρων δίνονται στο άρθρο Ενημέρωση ιδιοτήτων γραμματοσειράς για κείμενο σε έγγραφο του Word. Ο παρακάτω κώδικας ορίζει την οικογένεια γραμματοσειρών του κειμένου της κεφαλίδας σε Verdana, το μέγεθος του κειμένου σε 14 και το χρώμα του κειμένου σε μαύρο.

// Για ένα πλήρες παράδειγμα και αρχείο δεδομένων, μεταβείτε στη διεύθυνση https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/Examples/Aspose.Words.Cloud.Sdk.Examples/HeaderFooter /InsertHeadersAndPageNumbersToAWordDocument.cs

var runIndex = 0;
var fontDto = new Font { Bold = true, Name = "Verdana", Size = 14, Color = new XmlColor { Web = "#000000" }  };

// Εφαρμογή μορφοποίησης στην κεφαλίδα της πρώτης σελίδας
var documentParagraphRunFontRequest = new PostDocumentParagraphRunFontRequest(fileName, fontDto, "sections/0/headersfooters/1/paragraphs/0", runIndex);
var actual = wordsApi.PostDocumentParagraphRunFont(documentParagraphRunFontRequest);

// Εφαρμογή μορφοποίησης στην κεφαλίδα όλων των άλλων σελίδων
documentParagraphRunFontRequest = new PostDocumentParagraphRunFontRequest(fileName, fontDto, "sections/0/headersfooters/0/paragraphs/0", runIndex);
actual = wordsApi.PostDocumentParagraphRunFont(documentParagraphRunFontRequest);

Αφού πραγματοποιήσετε τις παραπάνω κλήσεις API, το έγγραφο εισόδου έχει την εξής μορφή:

Εισαγάγετε αριθμούς σελίδων σε ένα έγγραφο του Word

Το InsertPageNumbers API χρησιμοποιείται για την εισαγωγή αριθμών σελίδων σε ένα έγγραφο του Word. Το API δέχεται το ακόλουθο αντικείμενο JSON στο σώμα του:

{
  "Format": "string",
  "Alignment": "string",
  "IsTop": true,
  "SetPageNumberOnFirstPage": true
}

Εφόσον προσθέτουμε αριθμούς σελίδων στην κεφαλίδα, θα ορίσουμε την τιμή της παραμέτρου IsTop σε true. Ωστόσο, για να προσθέσετε αριθμούς σελίδων στο υποσέλιδο, ορίστε την τιμή σε false.

// Για ένα πλήρες παράδειγμα και αρχείο δεδομένων, μεταβείτε στη διεύθυνση https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/Examples/Aspose.Words.Cloud.Sdk.Examples/HeaderFooter /InsertHeadersAndPageNumbersToAWordDocument.cs

var body = new PageNumber { Alignment = "right", Format = "{PAGE} of {NUMPAGES}", IsTop = true, SetPageNumberOnFirstPage = true };

var insertPageNumbersRequest = new PostInsertPageNumbersRequest(fileName, body);
var actual = wordsApi.PostInsertPageNumbers(insertPageNumbersRequest);

Τέλος, προσθέσαμε κεφαλίδες και αριθμούς σελίδων στο έγγραφο.

Προτεινόμενη ανάρτηση:

Συνιστούμε επίσης να διαβάσετε τις ακόλουθες αναρτήσεις ιστολογίου για να μάθετε περισσότερα σχετικά με: