在制作演示文稿時，保持內容的一致性與可讀性至關重要，而段落首行縮進作為格式設置的關鍵環節，直接影響著整體呈現效果。在本文中，我們將介紹如何通過創建 ONLYOFFICE 宏，快速設置演示文稿中所有段落的首行縮進。

關于 ONLYOFFICE?

ONLYOFFICE?是一個國際開源項目，專注于高級和安全的文檔處理，可提供文本文檔、電子表格、幻燈片、表單和 PDF 編輯器。ONLYOFFICE 文檔高度兼容微軟 Office 格式，并提供數百種格式化和樣式工具，幫助您實現復雜的編輯功能。

ONLYOFFICE 不僅適合個人用戶，更為企業和商業開發提供了強大的支持。如果您需要為您的企業集成強大的編輯功能，或是為您的應用程序、網站或其他解決方案提供強大的編輯功能，您可以選擇企業版?/?開發者版。觀看下方視頻，了解關于我們的更多信息：

什么是 ONLYOFFICE 宏

如果您是一名資深 Microsoft Excel 用戶，那么相信您已對于 VBA 宏非常熟悉了。這些宏是幫助您自動執行日常任務的小型腳本。無論是重構數據，還是在單元格區域中插入多個值。ONLYOFFICE 宏的基礎是 JavaScript 語法與文檔生成器 API 方法。基于 JavaSript 的宏易于使用，具有跨平臺特性且十分安全。這就使得其與 VBA 相比有著顯著的優勢。

下面一起來看看如何創建宏，幫助您快速設置演示文稿中所有段落的首行縮進。

構建宏

設置縮進值

創建宏的第一步是確定每個段落首行的縮進值：

 const indentationValue = 720; 
/* Please enter the paragraph's first line indentation value. A value of 0 means no indentation,and any value greater than 0 will indent the text. The value is specified in twentieths of a point (1/1440 of an inch).*/

indentationValue：此常量用于定義段落首行的縮進距離，單位為“1點”的二十分之一（即1/1440英寸，約為1.27厘米）。它的默認值為720，相當于首行縮進0.5英寸（約1.27厘米）。如果該值為0，則代表不縮進；若該值為任意大于0的數，則段落首行會縮進。用戶可根據個人偏好自由調整段落縮進值。

獲取演示文稿和幻燈片數量

在獲取當前演示文稿之前，我們應當先確保宏只在用戶輸入的縮進值是有效且非負的數字時執行：

if (!isNaN(indentationValue) && indentationValue >= 0) {

接下來，使用?GetPresentation()?方法獲取當前演示文稿，并通過?GetSlidesCount()?方法獲取幻燈片總數：

        let presentation = Api.GetPresentation();let nSlides = presentation.GetSlidesCount(); // Get the number of slides in the presentation

循環遍歷幻燈片、文本框和段落

    // Loop through each slidefor (let slideIndex = 0; slideIndex < nSlides; slideIndex++) {let slide = presentation.GetSlideByIndex(slideIndex); // Get the slidelet aShapes = slide.GetAllShapes(); // Get all shapes in the slide// Loop through each shape in the slidefor (let shapeIndex = 0; shapeIndex < aShapes.length; shapeIndex++) {let content = aShapes[shapeIndex].GetDocContent(); // Get the document content of the shapeif (content) {let count = content.GetElementsCount(); // Get the number of elements (paragraphs) in the shape// Loop through each paragraph in the shapefor (let elementIndex = 0; elementIndex < count; elementIndex++) {let paragraph = content.GetElement(elementIndex); // Get the paragraph element

• GetSlideByIndex(slideIndex)：訪問演示文稿中特定索引位置的幻燈片對象。
• GetAllShapes()：獲取當前幻燈片中的所有圖形對象，包括文本框、圖片及其他元素。
• GetDocContent()：獲取特定圖形中的文檔內容，此方法會返回與圖形關聯的文本內容。
• GetElementsCount()：獲取特定圖形中元素（段落）的總數。
• GetElement(elementIndex)：根據提供的索引（elementIndex）訪問圖形中某個特定元素（段落）

在這部分，我們進行了以下操作：

1. 循環遍歷演示文稿中的所有幻燈片。
2. 循環遍歷幻燈片中的所有圖形（文本框）。
3. 獲取圖形中的文本內容。
4. 檢查圖形是否包含文本內容。
5. 循環遍歷圖形中每個元素（段落）。
6. 獲取段落元素。

調整段落首行縮進

我們使用?GetParaPr()?來獲取段落屬性，使用?SetIndFirstLine(indentationValue)?來調整首行縮進，最后能夠設置想要的段落首行縮進值：

                  let paraPr = paragraph.GetParaPr();paraPr.SetIndFirstLine(indentationValue);}}}}}

完整的宏代碼

完整的宏代碼如下所示：

(function () {const indentationValue = 720; 
/* Please enter the paragraph's first line indentation value. A value of 0 means no indentation, 
and any value greater than 0 will indent the text. The value is specified in twentieths of a point (1/1440 of an inch).*/if (!isNaN(indentationValue) && indentationValue >= 0) {let presentation = Api.GetPresentation();let nSlides = presentation.GetSlidesCount(); // Get the number of slides in the presentation// Loop through each slidefor (let slideIndex = 0; slideIndex < nSlides; slideIndex++) {let slide = presentation.GetSlideByIndex(slideIndex); // Get the slidelet aShapes = slide.GetAllShapes(); // Get all shapes in the slide// Loop through each shape in the slidefor (let shapeIndex = 0; shapeIndex < aShapes.length; shapeIndex++) {let content = aShapes[shapeIndex].GetDocContent(); // Get the document content of the shapeif (content) {let count = content.GetElementsCount(); // Get the number of elements (paragraphs) in the shape// Loop through each paragraph in the shapefor (let elementIndex = 0; elementIndex < count; elementIndex++) {let paragraph = content.GetElement(elementIndex); // Get the paragraph elementlet paraPr = paragraph.GetParaPr();paraPr.SetIndFirstLine(indentationValue);}}}}}
})();

這個宏提供了在演示文檔中給所有段落加上首行縮進的有效方法。它不僅能幫您節省時間，還能確保幻燈片整體風格的一致性。通過自動化處理首行縮進，你可以輕松完成精致、專業的排版布局，并將更多精力用于內容創作上。

我們鼓勵您探索?ONLYOFFICE API 方法，創建您自己的宏來進一步優化工作流程。如果您有任何想法或建議，請隨時聯系我們。期待得到您的反饋！

關于作者

Marija Vujanac：我是一名前端開發者，擁有土木工程背景，并且熱愛解決邏輯難題。在從事工程師工作多年，并通過圖庫攝影發揮創意之后，我找到了真正熱愛的事情，那就是通過編程來構建事物。我喜歡使用 JavaScript、React 和 Firebase 等技術來打造用戶友好的網頁體驗。在進行編程時，我常常沉浸其中，忘記了時間——我認為這是個好跡象！我始終在尋找新的成長方式，并希望能為有意義的項目作出貢獻。

立即獲取 ONLYOFFICE?

立即下載適用于 Windows、macOS 或 Linux 的?ONLYOFFICE 桌面編輯器，或注冊一個免費的協作空間帳戶，使用宏幫你提升工作效率！
ONLYOFFICE 桌面編輯器https://www.onlyoffice.com/zh/desktop.aspx?utm_source=csdn&utm_medium=article&utm_campaign=paragraph_indentation_in_presentation
協作空間https://www.onlyoffice.com/zh/docspace.aspx?utm_source=csdn&utm_medium=article&utm_campaign=paragraph_indentation_in_presentation

相關鏈接

ONLYOFFICE API?方法

GitHub 上的 ONLYOFFICE

更多 ONLYOFFICE 宏

獲取免費桌面辦公套件