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

بررسی اجمالی

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 for Android via Java همچنین به توسعه‌دهندگان امکان می‌دهد برخی از ویژگی‌های خط را تنظیم کنند تا ظاهر جذاب‌تری داشته باشد. بیایید چند ویژگی خط را تنظیم کنیم تا شبیه یک پیکان شود. برای این کار مراحل زیر را دنبال کنید:

• یک نمونه از کلاس Presentation ایجاد کنید.
• با استفاده از Index آن، مرجع یک اسلاید را به‌دست آورید.
• با استفاده از متد addAutoShape موجود در شیء IShapeCollection، یک AutoShape از نوع Line اضافه کنید.
• Line Style را به یکی از سبک‌های ارائه‌شده توسط Aspose.Slides for Android via Java تنظیم کنید.
• عرض خط را تنظیم کنید.
• Dash Style خط را به یکی از سبک‌های ارائه‌شده توسط Aspose.Slides for Android via 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();
}

پرسش‌های متداول

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

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

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

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

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

بله. اشکال قفل‌سازی شیء را فراهم می‌کنند که به شما امکان می‌دهد عملیات ویرایشی را غیرفعال کنید.