افزودن اشکال خط به ارائه‌ها در Java

بررسی کلی

Aspose.Slides به شما امکان می‌دهد اشکال خط را به اسلایدهای PowerPoint به‌صورت برنامه‌ای اضافه کنید. این مقاله نشان می‌دهد چگونه یک خط ساده ایجاد شود و چگونه خطی را سفارشی کنیم تا به‌صورت یک پیکان ظاهر شود.

شما می‌آموزید که چگونه یک شکل خط را به اسلاید اضافه کنید، ظاهر بصری آن را تنظیم کنید و ارائه به‌روزشده را ذخیره کنید. مثال‌ها بر تنظیمات عملی قالب‌بندی خط مانند سبک، عرض، الگوی نقطه‌خط، گزینه‌های سرپیکان و رنگ پر تمرکز دارند.

ایجاد یک خط ساده

برای اضافه کردن یک خط ساده به اسلاید انتخاب‌شده ارائه، مراحل زیر را دنبال کنید:

• یک نمونه از کلاس Presentation ایجاد کنید.
• با استفاده از Index آن، مرجع یک اسلاید را به دست آورید.
• با استفاده از متد addAutoShape که توسط شیء IShapeCollection ارائه می‌شود، یک AutoShape از نوع Line اضافه کنید.
• ارائهٔ تغییر یافته را به‌عنوان فایل PPTX بنویسید.

در مثال زیر، یک خط به اسلاید اول ارائه افزوده‌ایم.

// نمونه‌سازی کلاس PresentationEx که فایل PPTX را نمایندگی می‌کند
Presentation pres = new Presentation();
try {
    // دریافت اولین اسلاید
    ISlide sld = pres.getSlides().get_Item(0);
    
    // افزودن AutoShape از نوع خط
    sld.getShapes().addAutoShape(ShapeType.Line, 50, 150, 300, 0);
    
    // نوشتن PPTX بر روی دیسک
    pres.save("LineShape.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

ایجاد یک خط شبیه پیکان

Aspose.Slides برای Java همچنین به توسعه‌دهندگان امکان می‌دهد برخی از ویژگی‌های خط را تنظیم کنند تا ظاهر جذاب‌تری داشته باشد. بیایید چند ویژگی خط را طوری تنظیم کنیم که شبیه یک پیکان شود. برای انجام این کار مراحل زیر را دنبال کنید:

• یک نمونه از کلاس Presentation ایجاد کنید.
• با استفاده از Index آن، مرجع یک اسلاید را به دست آورید.
• با استفاده از متد addAutoShape که توسط شیء IShapeCollection ارائه می‌شود، یک AutoShape از نوع Line اضافه کنید.
• Line Style را به یکی از سبک‌های ارائه‌شده توسط Aspose.Slides برای Java تنظیم کنید.
• عرض خط را تنظیم کنید.
• Dash Style خط را به یکی از سبک‌های ارائه‌شده توسط Aspose.Slides برای Java تنظیم کنید.
• Arrow Head Style و Length نقطهٔ شروع خط را تنظیم کنید.
• Arrow Head Style و Length نقطهٔ پایان خط را تنظیم کنید.
• ارائهٔ تغییر یافته را به‌عنوان فایل PPTX بنویسید.

// نمونه‌سازی کلاس PresentationEx که فایل PPTX را نمایندگی می‌کند
Presentation pres = new Presentation();
try {
    // دریافت اولین اسلاید
    ISlide sld = pres.getSlides().get_Item(0);

    // افزودن AutoShape از نوع خط
    IAutoShape shp = sld.getShapes().addAutoShape(ShapeType.Line, 50, 150, 300, 0);

    // اعمال برخی قالب‌بندی‌ها بر روی خط
    shp.getLineFormat().setStyle(LineStyle.ThickBetweenThin);
    shp.getLineFormat().setWidth(10);

    shp.getLineFormat().setDashStyle(LineDashStyle.DashDot);

    shp.getLineFormat().setBeginArrowheadLength(LineArrowheadLength.Short);
    shp.getLineFormat().setBeginArrowheadStyle(LineArrowheadStyle.Oval);

    shp.getLineFormat().setEndArrowheadLength(LineArrowheadLength.Long);
    shp.getLineFormat().setEndArrowheadStyle(LineArrowheadStyle.Triangle);

    shp.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    shp.getLineFormat().getFillFormat().getSolidFillColor().setColor(new Color(PresetColor.Maroon));

    // نوشتن PPTX بر روی دیسک
    pres.save("LineShape.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

سؤالات متداول

آیا می‌توانم یک خط معمولی را به یک Connector تبدیل کنم تا به اشکال “چسبانده” شود؟

خیر. یک خط معمولی (یک AutoShape از نوع Line) به‌صورت خودکار به یک Connector تبدیل نمی‌شود. برای چسباندن به اشکال، از نوع ویژهٔ Connector و APIهای مرتبط [/slides/fa/java/connector/] استفاده کنید.

اگر ویژگی‌های یک خط از تم به ارث برده شده باشند و تعیین مقادیر نهایی دشوار باشد، باید چه کاری انجام دهم؟

خواندن ویژگی‌های مؤثر را از طریق رابط‌های ILineFormatEffectiveData/ILineFillFormatEffectiveData بخوانید—این‌ها پیشاپیش ارث‌بری و سبک‌های تم را در نظر می‌گیرند.

آیا می‌توانم یک خط را در مقابل ویرایش (جابه‌جایی، تغییر اندازه) قفل کنم؟

بله. اشکال lock objects را فراهم می‌کنند که به شما اجازه می‌دهد ممنوع کردن عملیات ویرایشی را اعمال کنید.