Швидкий перегляд трансформації документа MS Word.
Верхній колонтитул – це верхнє поле кожної сторінки, а нижній – нижнє поле кожної сторінки. Верхні та нижні колонтитули корисні для включення інформації, яку потрібно відображати на кожній сторінці документа, як-от ваше ім’я, дати, назва документа, номери сторінок або застереження щодо документів. Під час використання MS Word він надає можливість додавати верхні та нижні колонтитули на основі попередньо визначених макетів або дозволяє додавати власні колонтитули. Більшість вбудованих заголовків містять деякий текст-заповнювач, і ви можете зберегти текст-заповнювач або замінити його власним каналом даних. Крім того, під час оновлення інформації в розділі «Верхній або нижній колонтитул» вміст всередині основної частини документа стає сірим, що вказує на те, що ці об’єкти повністю ізольовані від решти вмісту сторінки, а операції, які ви виконуєте над цими об’єктами, є специфічними для цих областей. У цій статті ми дізнаємося, як додати або оновити нижній колонтитул у документі Word за допомогою REST API.
API обробки тексту
Aspose.Words Cloud API надає можливість завантажувати файли MS Word із хмарного сховища, а також дозволяє користувачеві передавати вхідний файл безпосередньо в тілі запиту, а API повертає оновлений файл в об’єкті відповіді. Він надає функції читання, додавання, оновлення або видалення певних або всіх об’єктів верхнього та нижнього колонтитулів. Крім того, ви також можете вказати відтворення різних верхніх/нижніх колонтитулів для першої сторінки та для непарних/парних сторінок.
Крім того, API також дозволяє встановлювати інформацію про форматування, таку як властивості шрифту та абзацу, для тексту верхнього/нижнього колонтитула. Ви також отримуєте можливість вставляти динамічні номери сторінок у розділ верхнього/нижнього колонтитулів. І останнє, але не менш важливе: ви можете використати об’єкти таблиці, щоб вирівняти одну частину тексту верхнього/нижнього колонтитула по лівому краю, а іншу – по правому краю.
Сфера застосування ст
Наш Aspose.Words Cloud SDK для .NET дозволяє вам працювати з Aspose.Words Cloud REST APIs швидко та легко, оскільки він піклується про низькі деталі щодо надсилання запитів та обробки відповідей, а також дозволяє зосередитися на написанні коду, що відповідає вимогам вашого бізнесу. У цій статті ми збираємося використовувати Aspose.Words Cloud SDK для .NET у Visual Studio для Mac. У цьому дописі описано, як вставити верхній колонтитул у документ Word, де буде визначено спеціальне форматування. Потім форматування вихідного вмісту нижнього колонтитула оновлюється, а інформація про номер сторінки вставляється в нижньому правому куті. Всі ці операції будуть виконуватися в хмарі.
монтаж
Щоб розпочати роботу, спершу вам потрібно інсталювати Visual Studio у вашій системі. Створіть зразок рішення та додайте посилання NuGet Aspose.Words Cloud SDK для .NET. Отже, щоб додати посилання, клацніть правою кнопкою миші рішення та виберіть пункт меню «Керувати пакетами NuGet…». Введіть Aspose.Words-Cloud у текстовому полі пошуку. Виберіть опцію та натисніть кнопку Додати пакет.
Тепер у рішенні з’являється посилання на Aspose.Words.Cloud.Sdk. Є деякі переваги використання хмарних API на відміну від локальних (aspose.com) API. Причина в тому, що вам не потрібно вручну відстежувати та оновлювати версії API, а також вам не потрібно платити за всю ліцензію.
Інформаційна панель Aspose.Cloud
Просто створіть обліковий запис на інформаційній панелі Aspose.Cloud або зареєструйтеся через наявний обліковий запис Google або GitHub і почніть використовувати наші хмарні API. Ще одна дивовижна особливість Cloud API полягає в тому, що ви можете використовувати їх на будь-якій платформі за допомогою будь-якої підтримуваної мови.
Як зазначено вище, у статті наголошується на варіантах додавання та оновлення об’єктів верхнього та нижнього колонтитулів у документах MS Word. Для тестування ми використали наявний шаблон документа MS Word із назвою Business Letter. Документ потрібно завантажити в хмарне сховище Aspose, і всі маніпуляції та обробка документів виконуватимуться через хмару. Після завершення всієї обробки ми також можемо завантажити отриману копію файлу з хмарного сховища.
using Aspose.Words.Cloud.Sdk;
using Aspose.Words.Cloud.Sdk.Model;
using Aspose.Words.Cloud.Sdk.Model.Requests;
Тепер, щоб використовувати Aspose.Cloud API, вам потрібно використовувати ключ додатка та інформацію SID додатка у вашому коді. Ці клавіші складаються з буквено-цифрових цифр. Це унікальні коди, пов’язані з обліковим записом вашої підписки. Щоб отримати ці відомості, натисніть вкладку «Мої програми» на інформаційній панелі Aspose.Cloud. Коли у нас є ключі, нам потрібно ініціалізувати об’єкт API Aspose.Words.
string MyAppKey = "f6axxxxxxxxxxxxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "478e4827-xxxxx-xxxx-xxxx-xxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// create an object of WordsApi while passing AppKey and AppSid information
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);
Вставити об’єкт «Заголовок».
Щоб додати об’єкт заголовка у файл MS Word, нам потрібно послідовно виконати наступні операції.
- Створіть об’єкт InsertHeaderFooterRequest, де ми передаємо тип HeaderFooterLink як аргумент.
- Вставте об’єкт HeaderFooterRequest в об’єкт WordsApi за допомогою методу InsertHeaderFooter (…).
- Створіть об’єкт Run, який містить зразок текстової інформації.
- Створіть об’єкт InsertRunRequest, де ми передаємо посилання абзацу (SectionPath) в об’єкт HeaderFooter, де потрібно додати текст Run.
Потім викличте метод InsertRun (…) WordsApi, який додає RunRequest до об’єкта HeaderFooter.
HeaderFooter.TypeEnum може бути одним із наведених нижче значень.
string MyAppKey = "xxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// створити об’єкт WordsAPI, передаючи інформацію AppKey і AppSid
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);
// завантажити зразок документа в хмарне сховище
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx",
FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));
// Вставити об’єкт заголовка на першу сторінку
var putHeaderFooterRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertHeaderFooterRequest("BusinessLetter.docx", "HeaderFirst", null,null);
var actual = wordsApi.InsertHeaderFooter(putHeaderFooterRequest);
// Створити об’єкт Run із зразком тексту
var run = new Run { Text = "Aspose.Words Cloud SDK for .NET " };
// додайте текст Run до першого абзацу першого об’єкта HeaderFooter у першому розділі документа Word
var runRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertRunRequest("BusinessLetter.docx", "sections/0/headersfooters/1/paragraphs/0", run);
// Вставте RunRequest в документ Word
var actual2 = wordsApi.InsertRun(runRequest);
Зображення попереднього перегляду нещодавно доданого заголовка
Оновити форматування тексту щойно вставленого заголовка
Після додавання об’єкта Header ми можемо оновити текстове форматування вмісту в ньому. Щоб виконати цю вимогу, нам потрібно виконати наступні кроки.
- Створюємо об’єкт класу Font, де вказуємо назву шрифту, розмір, інформацію про колір.
- Щоб зробити текст більш презентабельним, позначте властивість Engrave як True.
- Створіть об’єкт класу UpdateRunFontRequest, де ми передаємо вхідний файл, Font, SectionPath і runIndex як аргумент.
- Нарешті, скористайтеся методом UpdateRunFont(..) і додайте об’єкт UpdateRunFontRequest до екземпляра WordsApi.
string MyAppKey = "xxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// створити об’єкт WordsAPI, передаючи інформацію AppKey і AppSid
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);
// завантажити зразок документа в хмарне сховище
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx",
FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));
// Наступним кроком є встановлення форматування об’єкта заголовка
var runIndex = 0;
var fontDto = new Font { Bold = true, Name = "Verdana", Size = 16, Color = new XmlColor { Web = "#e0a50d" } };
// Встановіть форматування тексту як Engrave
fontDto.Engrave = true;
// Застосувати форматування до першого абзацу об’єкта HeaderFooter
var documentParagraphRunFontRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.UpdateRunFontRequest("BusinessLetter.docx",
fontDto, "sections/0/headersfooters/1/paragraphs/0", runIndex);
var actual4 = wordsApi.UpdateRunFont(documentParagraphRunFontRequest);
Зображення попереднього перегляду заголовка після застосування форматування тексту.
Оновити форматування існуючого об’єкта нижнього колонтитула
API також пропонує функцію оновлення форматування вмісту всередині існуючого об’єкта Верхній / Нижній колонтитул. Щоб виконати цю вимогу, ми можемо використовувати вказані вище рядки коду, але єдиною відмінністю є зміна індексу колонтитула на 2. Дивіться наступний рядок коду.
// Apply formatting to first paragraph of HeaderFooter object
var FooterDocumentParagraphRunFontRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.UpdateRunFontRequest("BusinessLetter.docx",
FooterFontDto, "sections/0/headersfooters/2/paragraphs/0", FooterrunIndex);
Зображення, на якому показано зміну форматування тексту нижнього колонтитула.
Додайте інформацію про номер сторінки в розділ нижнього колонтитула
Номери сторінок надають дуже корисну інформацію, наприклад поточну сторінку та загальну кількість сторінок у документі. Наступні кроки визначають, як виконати вимоги.
- Спочатку створіть об’єкт класу PageNumber, де ми визначаємо вирівнювання тексту, формат тексту, розташування для відтворення інформації PageNumber, а також вказуємо, чи потрібно відображати PageNumber на першій сторінці чи ні.
- Створіть об’єкт InsertPageNumbersRequest і передайте об’єкт PageNumber як аргумент.
- Нарешті, викличте метод InsertPageNumbers(..), щоб додати запит InsertPageNumbersRequest до екземпляра WordsApi.
string MyAppKey = "xxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// створити об’єкт WordsAPI, передаючи інформацію AppKey і AppSid
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);
// завантажити зразок документа в хмарне сховище
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx",
FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));
// API також пропонує функцію додавання деталей номера сторінки в об’єкт HeaderFooter
// Додайте інформацію про номер сторінки праворуч унизу сторінки
var body = new PageNumber { Alignment = "right", Format = "{PAGE} of {NUMPAGES}", IsTop = false, SetPageNumberOnFirstPage = true };
var insertPageNumbersRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertPageNumbersRequest("BusinessLetter.docx", body);
// Вставте інформацію про номер сторінки в документ Word
var actual6 = wordsApi.InsertPageNumbers(insertPageNumbersRequest);
Попередній перегляд номера сторінки в розділі нижнього колонтитула.
Висновок
У цій статті ми дізналися, як додати колонтитул у документ Word за допомогою Aspose.Words Cloud SDK для .NET. Зауважте, що ми також маємо Cloud SDK для Java, PHP, Ruby, Python, Go, Swift, C++, Node.Js, Android. Для отримання додаткової інформації відвідайте Aspose.Words Cloud.
Схожі статті
Ми також рекомендуємо відвідати наступний сайт, щоб дізнатися більше