在 .NET 中克隆簡報投影片
簡介
克隆是製作某物精確副本或複製的過程。Aspose.Slides 也允許您複製(克隆)任何投影片,然後將克隆的投影片插入到當前簡報或任何其他開啟的簡報中。投影片克隆會建立一個新投影片,開發人員可以在不影響原始投影片的情況下修改它。克隆投影片有多種方式:
- 在簡報的末端克隆。
- 在簡報的其他位置克隆。
- 在另一個簡報的末端克隆。
- 在另一個簡報的其他位置克隆。
- 在另一個簡報的特定位置克隆。
在 Aspose.Slides for .NET 中,由 Presentation 物件所公開的投影片集合(ISlide 物件的集合)提供 AddClone 與 InsertClone 方法,以執行上述的投影片克隆操作。
在簡報的末端克隆投影片
如果您想要克隆投影片並在同一簡報檔案的現有投影片末端使用它,請依照以下步驟使用 AddClone 方法:
- 建立 Presentation 類別的執行個體。
- 透過參考由 Presentation 物件所公開的 Slides 集合,實例化 ISlideCollection 類別。
- 呼叫由 ISlideCollection 物件公開的 AddClone 方法,並將要克隆的投影片作為參數傳遞給該方法。
- 寫入已修改的簡報檔案。
在下列範例中,我們將投影片(位於簡報的第一個位置——索引 0)克隆至簡報的末端。
// 實例化代表簡報檔案的 Presentation 類別
using (Presentation pres = new Presentation("CloneWithinSamePresentationToEnd.pptx"))
{
// 將所需的投影片克隆至同一簡報中投影片集合的末端
ISlideCollection slds = pres.Slides;
slds.AddClone(pres.Slides[0]);
// 將已修改的簡報寫入磁碟
pres.Save("Aspose_CloneWithinSamePresentationToEnd_out.pptx", SaveFormat.Pptx);
}
在簡報內的其他位置克隆投影片
如果您想要克隆投影片並在同一簡報檔案的其他位置使用它,請使用 InsertClone 方法:
- 建立 Presentation 類別的執行個體。
- 透過參考由 Presentation 物件所公開的 Slides 集合,實例化相應的類別。
- 呼叫由 ISlideCollection 物件公開的 InsertClone 方法,並將要克隆的投影片與新位置的索引作為參數傳遞給該方法。
- 將修改後的簡報寫入為 PPTX 檔案。
在下列範例中,我們將投影片(位於索引 0——位置 1——的投影片)克隆至索引 1——位置 2——的地方。
// 實例化代表簡報檔案的 Presentation 類別
using (Presentation pres = new Presentation("CloneWithInSamePresentation.pptx"))
{
// 將所需的投影片克隆至同一簡報中投影片集合的末端
ISlideCollection slds = pres.Slides;
// 將所需的投影片克隆至同一簡報中指定的索引位置
slds.InsertClone(2, pres.Slides[1]);
// 將已修改的簡報寫入磁碟
pres.Save("Aspose_CloneWithInSamePresentation_out.pptx", SaveFormat.Pptx);
}
在另一個簡報的末端克隆投影片
如果您需要從一個簡報克隆投影片並將其加入另一個簡報檔案的末端:
- 建立包含來源投影片的 Presentation 類別的執行個體。
- 建立包含目標簡報的 Presentation 類別的執行個體,該簡報將接收克隆的投影片。
- 透過參考目標簡報的 Presentation 物件所公開的 Slides 集合,實例化 ISlideCollection 類別。
- 呼叫由 ISlideCollection 物件公開的 AddClone 方法,並將來源簡報的投影片作為參數傳遞給該方法。
- 寫入已修改的目標簡報檔案。
在下列範例中,我們將來源簡報第一個索引的投影片克隆至目標簡報的末端。
// 實例化 Presentation 類別以載入來源簡報檔案
using (Presentation srcPres = new Presentation("CloneAtEndOfAnother.pptx"))
{
// 實例化用於目標 PPTX 的 Presentation 類別(投影片將被克隆的位置)
using (Presentation destPres = new Presentation())
{
// 將來源簡報中所需的投影片克隆至目標簡報投影片集合的末端
ISlideCollection slds = destPres.Slides;
slds.AddClone(srcPres.Slides[0]);
// 將目標簡報寫入磁碟
destPres.Save("Aspose2_out.pptx", SaveFormat.Pptx);
}
}
在另一個簡報的其他位置克隆投影片
如果您需要從一個簡報克隆投影片並在另一個簡報檔案的特定位置使用它:
- 建立包含來源簡報的 Presentation 類別的執行個體。
- 建立包含目標簡報的 Presentation 類別的執行個體。
- 透過參考目標簡報的 Presentation 物件所公開的 Slides 集合,實例化 ISlideCollection 類別。
- 呼叫由 ISlideCollection 物件公開的 InsertClone 方法,並將來源簡報的投影片與期望的位置作為參數傳遞給該方法。
- 寫入已修改的目標簡報檔案。
在下列範例中,我們將來源簡報的索引 0 的投影片克隆至目標簡報的索引 1(位置 2)。
// 實例化 Presentation 類別以載入來源簡報檔案
using (Presentation srcPres = new Presentation("CloneAtEndOfAnother.pptx"))
{
// 實例化用於目標 PPTX 的 Presentation 類別(投影片將被克隆的位置)
using (Presentation destPres = new Presentation())
{
ISlideCollection slds = destPres.Slides;
slds.InsertClone(2, srcPres.Slides[0]);
// 將目標簡報寫入磁碟
destPres.Save("Aspose2_out.pptx", SaveFormat.Pptx);
}
}
在另一個簡報的特定位置克隆帶有母片的投影片
如果您需要從一個簡報克隆帶有母片的投影片並在另一個簡報中使用,必須先將來源簡報的目標母片克隆至目標簡報,然後使用該母片來克隆投影片。AddClone(ISlide, IMasterSlide) 需要的是目標簡報中的母片,而不是來源簡報的母片。請依照以下步驟克隆帶母片的投影片:
- 建立包含來源簡報的 Presentation 類別的執行個體。
- 建立包含目標簡報的 Presentation 類別的執行個體。
- 取得要克隆的投影片及其母片。
- 透過參考目標簡報的 Presentation 物件所公開的 Masters 集合,實例化 IMasterSlideCollection 類別。
- 呼叫由 IMasterSlideCollection 物件公開的 AddClone 方法,將來源 PPTX 的母片作為參數傳遞。
- 透過參考目標簡報的 Presentation 物件所公開的 Slides 集合,實例化 ISlideCollection 類別。
- 呼叫由 ISlideCollection 物件公開的 AddClone 方法,將來源簡報的投影片與剛才克隆的母片作為參數傳遞。
- 寫入已修改的目標簡報檔案。
在下列範例中,我們將來源簡報零索引的投影片(帶有母片)克隆至目標簡報的末端,使用來源投影片的母片。
// 實例化 Presentation 類別以載入來源簡報檔案
using (Presentation srcPres = new Presentation("CloneToAnotherPresentationWithMaster.pptx"))
{
// 實例化用於目標簡報的 Presentation 類別(投影片將被克隆的位置)
using (Presentation destPres = new Presentation())
{
// 從來源簡報的投影片集合中實例化 ISlide,並同時取得
// 母片
ISlide SourceSlide = srcPres.Slides[0];
IMasterSlide SourceMaster = SourceSlide.LayoutSlide.MasterSlide;
// 將來源簡報中所需的母片克隆至目標簡報的母片集合中
// (Destination presentation)
IMasterSlideCollection masters = destPres.Masters;
IMasterSlide DestMaster = SourceSlide.LayoutSlide.MasterSlide;
// 將來源簡報中所需的母片克隆至目標簡報的母片集合中
// (Destination presentation)
IMasterSlide iSlide = masters.AddClone(SourceMaster);
// 從來源簡報中以所需的母片將投影片克隆至目標簡報投影片集合的末端
// (Collection of slides in the destination presentation)
ISlideCollection slds = destPres.Slides;
slds.AddClone(SourceSlide, iSlide, true);
// 將來源簡報中所需的母片克隆至目標簡報的母片集合中 // Destination presentation
// 將目標簡報寫入磁碟
destPres.Save("CloneToAnotherPresentationWithMaster_out.pptx", SaveFormat.Pptx);
}
}
在指定章節的末端克隆投影片
使用 Aspose.Slides for .NET,您可以從簡報的一個章節克隆投影片,並將該投影片插入同一簡報的另一個章節。此情況下,必須使用來自 ISlideCollection 介面的 AddClone 方法。
以下 C# 程式碼示範如何克隆投影片並將克隆的投影片插入指定章節:
using (Presentation pres = new Presentation())
{
ISlide slide = pres.Slides.AddEmptySlide(pres.Slides[0].LayoutSlide);
slide.Shapes.AddAutoShape(ShapeType.Ellipse, 150, 150, 100, 100); // 用於克隆
ISlide slide2 = pres.Slides.AddEmptySlide(pres.Slides[0].LayoutSlide);
ISection section = pres.Sections.AddSection("Section2", slide2);
pres.Slides.AddClone(slide, section);
pres.Save("pres.pptx", SaveFormat.Pptx);
}
常見問題
會一起克隆講者備註和審閱者評論嗎?
會。備註頁與審閱評論都會包含在克隆中。如果不需要,請在插入後 移除它們。
圖表及其資料來源如何處理?
圖表物件、格式以及嵌入的資料皆會被複製。若圖表連結至外部來源(例如 OLE 嵌入的活頁簿),該連結會以 OLE 物件 形式保留。搬移檔案後,請確認資料可用性並重新整理。
我能控制克隆的插入位置與章節嗎?
可以。您可以在指定的投影片索引插入克隆,並將其放入選定的 章節。若目標章節不存在,請先建立章節,然後再將投影片移入其中。