在 JavaScript 中管理簡報的繪圖參考線

本頁內容簡介

使用 Aspose.Slides for Node.js via Java 在 PowerPoint 簡報中新增、存取與清除水平與垂直繪圖參考線。

概觀

繪圖參考線是可調整的水平與垂直線條，可協助使用者在 PowerPoint 中編輯簡報時持續對齊形狀。當應用程式產生簡報，稍後需要手動精細調整時，它特別有用：應用程式可儲存相同的對齊輔助，作者在新增或移動內容時應遵循這些輔助。

繪圖參考線是編輯輔助工具，而非投影片內容。它們不會出現在投影片放映或渲染輸出中。Aspose.Slides for Node.js via Java 透過 DrawingGuidesCollection 類別公開它們。參考線由 DrawingGuide 表示，具備方向、位置和顏色。

位置以點 (points) 為單位，從相關投影片或母片的左上角測量。垂直參考線使用水平座標，通常在 0 到投影片寬度之間。水平參考線使用垂直座標，通常在 0 到投影片高度之間。

將參考線新增至投影片檢視

使用 CommonSlideViewProperties.getDrawingGuides 來管理在編輯普通投影片時顯示的參考線。呼叫 DrawingGuidesCollection.add，傳入 Orientation 值與點為單位的位置。

以下範例在投影片中心右側新增一條垂直參考線，並在其下方新增一條水平參考線：

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation();
try {
    const slideSize = presentation.getSlideSize().getSize();
    const guides = presentation.getViewProperties().getSlideViewProperties().getDrawingGuides();

    guides.add(slides.Orientation.Vertical, slideSize.getWidth() / 2 + 12.5);
    guides.add(slides.Orientation.Horizontal, slideSize.getHeight() / 2 + 12.5);

    presentation.save("drawing-guides.pptx", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

存取繪圖參考線

DrawingGuidesCollection.getCount 與 DrawingGuidesCollection.get_Item 方法提供對現有參考線的存取。DrawingGuide.getOrientation、DrawingGuide.getPosition 與 DrawingGuide.getColor 方法返回的值亦可透過對應的設定子方法進行變更。

以下範例讀取先前建立之簡報的投影片檢視參考線：

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation("drawing-guides.pptx");
try {
    const guides = presentation.getViewProperties().getSlideViewProperties().getDrawingGuides();

    for (let index = 0; index < guides.getCount(); index++) {
        const guide = guides.get_Item(index);
        console.log("Guide " + index + ": orientation = " + guide.getOrientation() + ", position = " + guide.getPosition() + ", color = " + guide.getColor());
    }
} finally {
    presentation.dispose();
}

將參考線新增至母片與版面投影片

投影片母片及其每個版面投影片皆可擁有各自的繪圖參考線集合。對於母片使用 MasterSlide.getDrawingGuides，對於版面投影片使用 LayoutSlide.getDrawingGuides。

以下範例在第一個母片投影片新增一條垂直參考線，並在第一個版面投影片新增一條水平參考線：

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation();
try {
    const slideSize = presentation.getSlideSize().getSize();
    const masterGuides = presentation.getMasters().get_Item(0).getDrawingGuides();
    const layoutGuides = presentation.getLayoutSlides().get_Item(0).getDrawingGuides();

    masterGuides.add(slides.Orientation.Vertical, slideSize.getWidth() / 2 - 20);
    layoutGuides.add(slides.Orientation.Horizontal, slideSize.getHeight() / 2 + 20);

    presentation.save("master-layout-drawing-guides.pptx", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

將參考線新增至備註與講義母片

備註母片與講義母片也支援繪圖參考線。使用 MasterNotesSlide.getDrawingGuides 與 MasterHandoutSlide.getDrawingGuides 以存取它們的集合。如果簡報未包含這些母片之一，MasterNotesSlideManager.setDefaultMasterNotesSlide 或 MasterHandoutSlideManager.setDefaultMasterHandoutSlide 會建立預設母片並回傳它。

以下範例在備註母片新增一條水平參考線，並在講義母片新增一條垂直參考線：

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation();
try {
    const notesSize = presentation.getNotesSize().getSize();
    const notesMaster = presentation.getMasterNotesSlideManager().setDefaultMasterNotesSlide();
    const handoutMaster = presentation.getMasterHandoutSlideManager().setDefaultMasterHandoutSlide();

    notesMaster.getDrawingGuides().add(slides.Orientation.Horizontal, notesSize.getHeight() / 2 + 50);
    handoutMaster.getDrawingGuides().add(slides.Orientation.Vertical, notesSize.getWidth() / 2 - 50);

    presentation.save("notes-handout-drawing-guides.pptx", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

清除繪圖參考線

呼叫 DrawingGuidesCollection.clear 可移除特定集合中的所有參考線。清除單一集合不會影響其他範圍中儲存的參考線。

以下範例在不建立缺少母片的情況下，清除投影片檢視參考線以及投影片母片、版面投影片、備註母片與講義母片上的所有參考線：

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation("presentation-with-guides.pptx");
try {
    presentation.getViewProperties().getSlideViewProperties().getDrawingGuides().clear();

    for (let index = 0; index < presentation.getMasters().size(); index++) {
        presentation.getMasters().get_Item(index).getDrawingGuides().clear();
    }

    for (let index = 0; index < presentation.getLayoutSlides().size(); index++) {
        presentation.getLayoutSlides().get_Item(index).getDrawingGuides().clear();
    }

    const notesMaster = presentation.getMasterNotesSlideManager().getMasterNotesSlide();
    if (notesMaster !== null) {
        notesMaster.getDrawingGuides().clear();
    }

    const handoutMaster = presentation.getMasterHandoutSlideManager().getMasterHandoutSlide();
    if (handoutMaster !== null) {
        handoutMaster.getDrawingGuides().clear();
    }

    presentation.save("presentation-without-guides.pptx", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

常見問題

繪圖參考線會出現在投影片放映或匯出圖像中嗎？

不會。繪圖參考線是用於編輯的對齊輔助，並不會作為簡報內容呈現。

可以直接將繪圖參考線新增至個別普通投影片嗎？

普通投影片的編輯參考線儲存在簡報的投影片檢視屬性中。投影片母片、版面投影片、備註母片與講義母片各自有獨立的參考線集合。

參考線位置使用哪種單位？

位置以點（points）為單位，1 英吋等於 72 點。垂直位置以左邊緣為測量起點，水平位置以上邊緣為測量起點。

清除繪圖參考線會移除圖形或變更投影片內容嗎？

不會。 DrawingGuidesCollection.clear 方法僅會移除所選集合中的參考線。圖形及其他投影片內容保持不變。

使用 JavaScript 在簡報中管理投影片過渡使用 JavaScript 管理簡報中的投影片章節