სათაური არის დოკუმენტის განყოფილება, რომელიც გამოჩნდება ზედა ზღვარზე და ზოგადად შეიცავს ინფორმაციას, როგორიცაა გვერდის ნომერი, თარიღი და დოკუმენტის სახელი. Aspose.Words REST APIs-ით შეგიძლიათ ჩასვათ გვერდის ნომერი Word დოკუმენტში, ასევე გვერდის სათაურებში. ნაგულისხმევად, სათაურები ერთნაირია თითოეულ გვერდზე, მაგრამ ჩვენ შეგვიძლია შევქმნათ განსხვავებული სათაურები კენტი და ლუწი გვერდებისთვის.

ეს პოსტი მიზნად ისახავს დოკუმენტის შემდეგი განლაგების მიღწევას, რომელშიც პირველ გვერდზე სათაური განსხვავდება დანარჩენი გვერდებისგან:

ჩადეთ გვერდის ნომერი
სათაურის ჩასმა

ნებისმიერი Aspose REST API-ს გამოძახებამდე, ჩვენ უნდა შევქმნათ Aspose Cloud ანგარიში და მივიღოთ ჩვენი App Key და App SID. დაწყება სტატია განმარტავს, თუ როგორ უნდა შეასრულოთ ეს ნაბიჯები.

გარდა ამისა, ჩვენ უნდა ავტვირთოთ ნიმუშის დოკუმენტი Cloud Storage-ში, რადგან დოკუმენტზე ყველა ოპერაცია შესრულდება ღრუბელში:

// სრული მაგალითისა და მონაცემთა ფაილის სანახავად, გთხოვთ, ეწვიოთ 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 APIs” ტექსტს ყველა სხვა სათაურში:

// სრული მაგალითისა და მონაცემთა ფაილის სანახავად, გთხოვთ, ეწვიოთ 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);

გამოიყენეთ ფორმატირება სათაურის ტექსტზე

ფორმატირება შეიძლება გამოყენებულ იქნას სათაურის ტექსტზე Update Run Font API-ის გამოყენებით. API იღებს fontDto ობიექტს თავის სხეულში, რომლის Resource Properties-ის დეტალები მოცემულია Update font თვისებები ტექსტისთვის 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);

საბოლოოდ, ჩვენ დავამატეთ სათაურები და გვერდის ნომრები დოკუმენტში.

შემოთავაზებული პოსტი:

ჩვენ ასევე გირჩევთ გადახედოთ შემდეგ ბლოგ პოსტებს, რომ მეტი გაიგოთ: