ONLYOFFICE Docs，作為一款功能強大的在線編輯器，適用于您使用的平臺的文本文檔、電子表格、演示文稿、表單和 PDF 閱讀器。此次 ONLYOFFICE發布全新版本8.3,整個套件具有多項增強功能↓↓↓

ONLYOFFICE Docs 最新下載

ONLYOFFICE 宏是功能強大的工具，允許用戶擴展編輯器的功能并對其進行自定義以滿足特定需求。在 ONLYOFFICE，我們致力于通過新功能不斷增強我們的產品。隨著版本8.3的發布，我們引入了一系列旨在簡化您的工作流程的新 API 方法。在這篇教程中，我們將使用其中一種方法創建一個宏，從第二頁開始在整個文檔中插入自定義頁碼。

關于SetStartPageNumber方法

方法是類的一部分。此新方法允許您定義文檔中特定部分的起始頁碼。以下是其實現的示例：

let doc = Api.GetDocument(); let paragraph = doc.GetElement(0);
paragraph.AddText("This section starts with second page number");
paragraph.AddPageBreak();
paragraph.AddText("Third page");
paragraph.AddPageBreak();
paragraph.AddText("Fourth page"); let section = paragraph.GetSection();
section.SetStartPageNumber(2); let header = section.GetHeader("default", true);
paragraph = header.GetElement(0);
paragraph.AddText("Page #");
paragraph.AddPageNumber(); let footer = section.GetFooter("default", true);
paragraph = footer.GetElement(0);
paragraph.AddText("Page #");
paragraph.AddPageNumber();

在這篇博文的后面，我們將使用此方法來設置文檔第二頁的起始頁碼。

構建宏

檢索文檔和章節

該宏首先使用Api.GetDocument()訪問活動文檔。它使用doc.GetSections()[0]
檢索第一部分，該部分代表第一頁：

let doc = Api.GetDocument(); let firstSection = doc.GetSections()[0];

配置第一頁

// First Page Configuration
firstSection.SetTitlePage(true);
// Remove first page header/footer
firstSection.RemoveHeader("title");
firstSection.RemoveFooter("title");

• SetTitlePage(true)將第一頁標記為標題頁。
• RemoveHeader(“title”)和RemoveFooter(“title”)確保標題頁上不出現頁眉或頁腳。

設置后續頁面

// Subsequent Pages Configuration
let finalSection = doc.GetFinalSection();
finalSection.SetStartPageNumber(0); // Sets start page number. Default is 0 => 1st numbered page is 1

• finalSection變量代表將應用頁眉、頁腳和頁碼的部分。
• SetStartPageNumber(0)確保編號從第二頁正確開始，使第一個編號頁面為“1”。

配置標頭

// Header Configuration
let header = finalSection.GetHeader("default", true);
const headerText = header.GetElement(0);
headerText.AddPageNumber();
// Choose header justification (uncomment one):
//headerText.SetJc("left"); // Left alignment 
headerText.SetJc("center"); // Center alignment 
//headerText.SetJc("right"); // Right alignment

• GetHeader（“default”，true）檢索該部分的標題。
• 使用GetElement(0)訪問標題的第一個元素。
• AddPageNumber()插入動態頁碼。
• SetJc ()方法定義標題文本的對齊方式，將其定位在左側、居中或右側。

配置頁腳

// Footer Configuration - uncomment for inserting a page number in the footer
let footer = finalSection.GetFooter("default", true);
const footerText = footer.GetElement(0);
footerText.AddPageNumber();

// Choose footer justification (uncomment one):
// footerText.SetJc("left");    // Left alignment
footerText.SetJc("center");  // Center alignment
// footerText.SetJc("right");   // Right alignment

• 使用GetElement(0)訪問頁腳的第一個元素。
• AddPageNumber()在頁腳插入動態頁碼。
• SetJc ()方法控制頁腳文本的對齊方式，與頁眉類似。

注意！默認情況下，頁腳配置被注釋掉。只需注釋或取消注釋相關部分，即可在頁眉、頁腳或兩者之間切換插入編號。

整個宏如下：

let doc = Api.GetDocument();
let firstSection = doc.GetSections()[0];

// First Page Configuration
firstSection.SetTitlePage(true);
// Remove first page header/footer
firstSection.RemoveHeader("title");
firstSection.RemoveFooter("title");

// Subsequent Pages Configuration
let finalSection = doc.GetFinalSection();
finalSection.SetStartPageNumber(0); // Sets start page number. Default is 0 => 1st numbered page is 1

// Header Configuration
let header = finalSection.GetHeader("default", true);
const headerText = header.GetElement(0);
headerText.AddPageNumber();

// Choose header justification (uncomment one):
//headerText.SetJc("left"); // Left alignment 
headerText.SetJc("center"); // Center alignment 
//headerText.SetJc("right"); // Right alignment

// Footer Configuration - uncomment for inserting a page number in the footer
// let footer = finalSection.GetFooter("default", true);
// const footerText = footer.GetElement(0);
// footerText.AddPageNumber();

// Choose footer justification (uncomment one):
// footerText.SetJc("left");    // Left alignment
// footerText.SetJc("center");  // Center alignment
// footerText.SetJc("right");   // Right alignment

讓我們運行宏并看看它是如何工作的！

我們希望此宏能成為您工具包中有價值的補充，幫助您簡化工作流程。在 ONLYOFFICE，我們致力于為用戶提供多功能功能和靈活性，以滿足他們的特定需求。

在最近的發布中，我們為 API 庫引入了大量新方法。歡迎您探索這些增強功能并創建自己的宏。

慧都是ONLYOFFICE在中國的官方授權代理商，提供ONLYOFFICE系列產品免費試用，咨詢，正版銷售等于一體的專業化服務。

下載|體驗更多ONLYOFFICE產品，請咨詢，或撥打產品熱線：023-68661681