کلون اسلایدهای ارائه در .NET
مقدمه
کلونینگ فرآیند ایجاد یک کپی دقیق یا نسخهی مشابه از چیزی است. Aspose.Slides همچنین اجازه میدهد تا هر اسلایدی را کپی (کلون) کنید و سپس اسلاید کلون شده را در ارائهٔ فعلی یا هر ارائهٔ باز دیگری وارد کنید. کلونینگ اسلاید یک اسلاید جدید ایجاد میکند که توسعهدهندگان میتوانند بدون تأثیر بر اسلاید اصلی، آن را اصلاح کنند. چند روش برای کلون کردن یک اسلاید وجود دارد:
- کلون در انتهای یک ارائه.
- کلون در موقعیت دیگری درون یک ارائه.
- کلون در انتهای ارائهٔ دیگر.
- کلون در موقعیت دیگری در ارائهٔ دیگر.
- کلون همراه با اسلاید اصلی آن به ارائهٔ دیگر.
در Aspose.Slides for .NET، مجموعه اسلایدها (یک مجموعه از اشیاء ISlide ) که توسط شی Presentation ارائه میشود، متدهای AddClone و InsertClone را برای انجام عملیات کلونینگ اسلاید که در بالا توصیف شدهاند، فراهم میکند.
کلون یک اسلاید در انتهای ارائه
اگر میخواهید یک اسلاید را کلون کنید و سپس آن را در همان فایل ارائه در انتهای اسلایدهای موجود استفاده کنید، از متد AddClone طبق مراحل زیر استفاده کنید:
- یک نمونه از کلاس Presentation ایجاد کنید.
- کلاس ISlideCollection را با ارجاع به مجموعه Slides که توسط شی Presentation نمایان میشود، نمونهسازی کنید.
- متد AddClone که توسط شی ISlideCollection ارائه شده است، فراخوانی کنید و اسلایدی که باید کلون شود را به عنوان پارامتر به این متد پاس دهید.
- فایل ارائهٔ اصلاحشده را بنویسید.
در مثال زیر، ما یک اسلاید (در موقعیت اول – ایندکس صفر – ارائه) را به انتهای ارائه کلون کردهایم.
using Aspose.Slides;
using Aspose.Slides.Export;
// نمونهسازی کلاس 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 ایجاد کنید.
- با ارجاع به مجموعه Slides که توسط شی Presentation نمایان میشود، کلاس را نمونهسازی کنید.
- متد InsertClone که توسط شی ISlideCollection ارائه شده است، فراخوانی کنید و اسلایدی که باید کلون شود را به همراه ایندکس موقعیت جدید به عنوان پارامتر به این متد پاس دهید.
- ارائهٔ اصلاحشده را به شکل فایل PPTX بنویسید.
در مثال زیر، ما یک اسلاید (در ایندکس 1 – موقعیت 2 – ارائه) را به ایندکس 2 – موقعیت 3 – ارائه کلون کردهایم.
using Aspose.Slides;
using Aspose.Slides.Export;
// نمونهسازی کلاس 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 ایجاد کنید که شامل ارائهٔ مقصد است که اسلاید به آن اضافه میشود.
- کلاس ISlideCollection را با ارجاع به مجموعه Slides که توسط شی Presentation ارائهٔ مقصد نمایان میشود، نمونهسازی کنید.
- متد AddClone را که توسط شی ISlideCollection ارائه شده است، فراخوانی کنید و اسلایدی که از ارائهٔ منبع آمده است را به عنوان پارامتر به این متد پاس دهید.
- فایل ارائهٔ مقصد اصلاحشده را بنویسید.
در مثال زیر، ما یک اسلاید (از ایندکس اول ارائهٔ منبع) را به انتهای ارائهٔ مقصد کلون کردهایم.
using Aspose.Slides;
using Aspose.Slides.Export;
// نمونهسازی کلاس Presentation برای بارگذاری فایل ارائه منبع
using (Presentation srcPres = new Presentation("CloneAtEndOfAnother.pptx"))
{
// نمونهسازی کلاس Presentation برای PPTX مقصد (جایی که اسلاید باید کلون شود)
using (Presentation destPres = new Presentation())
{
// کلون اسلاید موردنظر از ارائه منبع به انتهای مجموعه اسلایدها در ارائه مقصد
ISlideCollection slds = destPres.Slides;
slds.AddClone(srcPres.Slides[0]);
// نوشتن ارائه مقصد به دیسک
destPres.Save("Aspose2_out.pptx", SaveFormat.Pptx);
}
}
کلون یک اسلاید به موقعیت دیگری در ارائهٔ دیگر
اگر نیاز دارید یک اسلاید را از یک ارائه گرفته و در موقعیت خاصی از ارائهٔ دیگر استفاده کنید:
- یک نمونه از کلاس Presentation ایجاد کنید که شامل ارائهٔ منبع است.
- یک نمونه از کلاس Presentation ایجاد کنید که شامل ارائهٔ مقصد است.
- کلاس ISlideCollection را با ارجاع به مجموعه Slides که توسط شی Presentation ارائهٔ مقصد نمایان میشود، نمونهسازی کنید.
- متد InsertClone را که توسط شی ISlideCollection ارائه شده است، فراخوانی کنید و اسلایدی که از ارائهٔ منبع میآید را به همراه موقعیت موردنظر به عنوان پارامتر به این متد پاس دهید.
- فایل ارائهٔ مقصد اصلاحشده را بنویسید.
در مثال زیر، ما یک اسلاید (از ایندکس صفر ارائهٔ منبع) را به ایندکس 1 (موقعیت 2) ارائهٔ مقصد کلون کردهایم.
using Aspose.Slides;
using Aspose.Slides.Export;
// نمونهسازی کلاس Presentation برای بارگذاری فایل ارائه منبع
using (Presentation srcPres = new Presentation("CloneAtEndOfAnother.pptx"))
{
// نمونهسازی کلاس Presentation برای PPTX مقصد (جایی که اسلاید باید کلون شود)
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 ایجاد کنید که شامل ارائهٔ مقصد است.
- به اسلایدی که باید کلون شود همراه با اسلاید اصلی آن دسترسی پیدا کنید.
- کلاس IMasterSlideCollection را با ارجاع به مجموعه Masters که توسط شی Presentation ارائهٔ مقصد نمایان میشود، نمونهسازی کنید.
- متد AddClone را که توسط شی IMasterSlideCollection ارائه شده است، فراخوانی کنید و اسلاید اصلی از PPTX منبع را به عنوان پارامتر به این متد پاس دهید.
- کلاس ISlideCollection را با تنظیم ارجاع به مجموعه Slides که توسط شی Presentation ارائهٔ مقصد نمایان میشود، نمونهسازی کنید.
- متد AddClone را که توسط شی ISlideCollection ارائه شده است، فراخوانی کنید و اسلاید از ارائهٔ منبع به همراه اسلاید اصلی را به عنوان پارامتر به این متد پاس دهید.
- فایل ارائهٔ مقصد اصلاحشده را بنویسید.
در مثال زیر، ما یک اسلاید با اسلاید اصلی (در ایندکس صفر ارائهٔ منبع) را به انتهای ارائهٔ مقصد با استفاده از اسلاید اصلی منبع کلون کردهایم.
using Aspose.Slides;
using Aspose.Slides.Export;
// نمونهسازی کلاس 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;
// کلون اسلاید اصلی موردنظر از ارائه منبع به مجموعه اسلایدهای اصلی در
// ارائه مقصد
IMasterSlideCollection masters = destPres.Masters;
IMasterSlide DestMaster = SourceSlide.LayoutSlide.MasterSlide;
// کلون اسلاید اصلی موردنظر از ارائه منبع به مجموعه اسلایدهای اصلی در
// ارائه مقصد
IMasterSlide iSlide = masters.AddClone(SourceMaster);
// کلون اسلاید موردنظر از ارائه منبع با اسلاید اصلی موردنظر به انتهای
// مجموعه اسلایدها در ارائه مقصد
ISlideCollection slds = destPres.Slides;
slds.AddClone(SourceSlide, iSlide, true);
// کلون اسلاید اصلی موردنظر از ارائه منبع به مجموعه اسلایدهای اصلی در // ارائه مقصد
// ذخیرهٔ ارائه مقصد به دیسک
destPres.Save("CloneToAnotherPresentationWithMaster_out.pptx", SaveFormat.Pptx);
}
}
کلون یک اسلاید در انتهای بخش مشخصی
با Aspose.Slides for .NET میتوانید یک اسلاید را از یک بخش از ارائه کلون کنید و آن اسلاید را در بخش دیگری از همان ارائه وارد کنید. در این حالت باید از متد AddClone از اینترفیس ISlideCollection استفاده کنید.
این کد C# نشان میدهد چگونه یک اسلاید را کلون کنید و اسلاید کلونشده را در بخش مشخصی وارد کنید:
using Aspose.Slides;
using Aspose.Slides.Export;
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);
}
اطمینان از تطابق اندازه اسلاید
هنگام کلون کردن اسلایدها به ارائهٔ دیگر، اطمینان حاصل کنید اندازهٔ اسلاید ارائهٔ مقصد با منبع یکسان باشد. اگر اندازهها متفاوت باشند، Aspose.Slides بهطور خودکار مقیاس اشکال کلونشده را تغییر نمیدهد؛ مختصات و ابعاد اولیه حفظ میشوند که ممکن است محتوا بهنظر ناهماهنگ برسد یا از محدودهٔ اسلاید فراتر رود.
قبل از کلون کردن اسلایدها و اسلاید اصلی میتوانید اندازهٔ اسلاید ارائهٔ مقصد را همانند منبع تنظیم کنید:
SizeF sourceSize = sourcePresentation.SlideSize.Size;
targetPresentation.SlideSize.SetSize(
sourceSize.Width, sourceSize.Height, SlideSizeScaleType.DoNotScale);
این کار را پیش از کلون کردن اسلاید اصلی و اسلاید انجام دهید.
پرسشهای متداول
آیا یادداشتهای سخنران و نظرات مرورگر کلون میشوند؟
بله. صفحه یادداشتها و نظرات مرورگر در کلون گنجانده میشوند. اگر نمیخواهید آنها را داشته باشید، پس از درج آنها را حذف کنید.
چگونه نمودارها و منابع داده آنها مدیریت میشوند؟
شیء نمودار، فرمتبندی و دادههای جاسازی شده کپی میشوند. اگر نمودار به منبع خارجی (مثلاً یک کاربرگ OLE) لینک شده باشد، این لینک بهعنوان یک شیء OLE حفظ میشود. پس از جابجایی بین فایلها، در دسترس بودن دادهها و رفتار تازهسازی را بررسی کنید.
آیا میتوانم موقعیت درج و بخشها را برای کلون کنترل کنم؟
بله. میتوانید کلون را در ایندکس اسلاید خاصی درج کنید و آن را در یک بخش انتخابی قرار دهید. اگر بخش هدف وجود نداشته باشد، ابتدا آن را ایجاد کنید و سپس اسلاید را به آن منتقل کنید.