API الأساسية Aspose.Slides FOSS for Java

مقدمة

Aspose.Slides FOSS for Java is a free, open-source library that lets Java developers create and manipulate PowerPoint presentations without any dependency on Microsoft Office. The library ships under the org.aspose.slides.foss حزمة و أهداف Java 21 وما فوق.

يتم إصدار المشروع تحت ترخيص MIT ، لذلك يمكنك استخدامه في كل من المشاريع الشخصية والتجارية بأي ثمن وبدون مفتاح API. يوفر نموذجًا غنيًّا للأشكال والنصوص والجدول والصور والتعليقات والوثائق ، مدعومًًى بالتلاعب المباشر بتنسيق حزمة Office Open XML.

مع 273 فئة، وأكثر من 2600 طريقة، و 42 قائمة، وتغطي API الأساسية الكتل التي تحتاج إلى تلقائي تدفقات العمل العرض في أي تطبيق جاوا.

ما هو مدرجة

عرض دورة الحياة

وَالْمُتَّقِينَ Presentation الفئة هي نقطة الدخول لكل عملية.يمكنك إنشاء عرض فارغ وتخزين النتيجة على القرص أو على OutputStream في مجموعة متنوعة من الأساليب، وتتضمن الفصول الدراسية AutoCloseable,لذلك يعمل بشكل طبيعي مع كتلة الموارد المحاولة.

import org.aspose.slides.foss.*;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation pres = new Presentation()) {
    // A new presentation starts with one blank slide
    System.out.println("Slides: " + pres.getSlides().size());
    pres.save("output.pptx", SaveFormat.PPTX);
}

إدارة Slide

SlideCollection يقدم السيطرة الكاملة على غطاء الشرائح.يمكنك إضافة شرائط خفيفة مع addEmptySlide(),- تكرار الشرائح الموجودة مع addClone(),إدخال اللوحات في مؤشر معين مع insertEmptySlide(),إزالة الشرائح عن طريق الإشارة أو المؤشر، وإيترات على المجموعة.

try (Presentation pres = new Presentation()) {
    ILayoutSlide layout = pres.getLayoutSlides().get(0);
    pres.getSlides().addEmptySlide(layout);
    pres.getSlides().addClone(pres.getSlides().get(0));
    System.out.println("Total slides: " + pres.getSlides().size());
}

أشكال و أوتوماتيك

وَالْمُتَّقِينَ AutoShape فئة تمثل الكائن الأكثر شيوعاً على الشريط.أنت تخلق أشكال من خلال IShapeCollection.addAutoShape(),وتحديد أ ShapeType كالمتواصل (مثل ShapeType.RECTANGLE- إعدادات منسقة لكل منهما. AutoShape يظهر أ TextFrame في نص المقالة و أ FillFormat من أجل التصميم البصري.

try (Presentation pres = new Presentation()) {
    ISlide slide = pres.getSlides().get(0);
    IAutoShape shape = slide.getShapes().addAutoShape(
        ShapeType.RECTANGLE, 50, 50, 300, 100, false);
    ITextFrame tf = shape.addTextFrame("Hello from Aspose.Slides FOSS");
    System.out.println(tf.getText());
}

النص والفقرات

ويُنظر إلى النص الغني كهيارقة من TextFrame, ParagraphCollection, Paragraph, PortionCollection,و ، و Portion يمكنك إعداد النص المسطح على الإطار مباشرة مع TextFrame.setText(),أو بناء الفقرات متعددة التشغيل عن طريق إضافة فردي Portion الحالات مع تنسيق منفصل.

try (Presentation pres = new Presentation()) {
    ISlide slide = pres.getSlides().get(0);
    IAutoShape shape = slide.getShapes()
        .addAutoShape(ShapeType.RECTANGLE, 50, 50, 400, 100, false);
    ITextFrame tf = shape.addTextFrame("First run ");
    Portion extra = new Portion("second run");
    tf.getParagraphs().get(0).getPortions().add(extra);
    System.out.println(tf.getText());
}

ملكية الوثيقة

وَالْمُتَّقِينَ DocumentProperties فئة يعرض الحقول الميتا بيانات قياسية مثل العنوان، المؤلف، الموضوع، الكلمات الرئيسية، الفئة، والظروف الزمنية.الخصائص مستمرة في PPTX النواة وتمديد الخصومات الأجزاء والبقاء على قيد الحياة دورة التخزين/إعادة تحميل.

try (Presentation pres = new Presentation()) {
    IDocumentProperties props = pres.getDocumentProperties();
    props.setTitle("Quarterly Report");
    props.setAuthor("Engineering Team");
    pres.save("report.pptx", SaveFormat.PPTX);
}

التعليقات والتوضيحات

ويشمل النظام الفرعي التعليقات CommentAuthorCollection و CommentCollection.يمكنك إضافة المؤلفين، وإرفاق التعليقات إلى الشرائح والمواقع المحددة، وقراءة الملاحظات الموجودة. ppt/commentAuthors.xml و ppt/comments/*.xml أجزاء من حزمة PPTX.

بدء سريع

إضافة إدمان الماين إلى الخاص بك pom.xml:

<dependency>
  <groupId>org.aspose</groupId>
  <artifactId>aspose-slides-foss</artifactId>
  <version>26.7.0</version>
</dependency>

ثم قم بإنشاء وتخزين عرض:

import org.aspose.slides.foss.*;
import org.aspose.slides.foss.export.SaveFormat;

public class QuickStart {
    public static void main(String[] args) {
        try (Presentation pres = new Presentation()) {
            ISlide slide = pres.getSlides().get(0);

            // Add a title shape
            IAutoShape title = slide.getShapes().addAutoShape(
                ShapeType.RECTANGLE, 50, 30, 600, 60, false);
            title.addTextFrame("Aspose.Slides FOSS for Java");

            // Add a content shape
            IAutoShape body = slide.getShapes().addAutoShape(
                ShapeType.RECTANGLE, 50, 120, 600, 300, false);
            body.addTextFrame(
                "This presentation was created entirely in Java "
                + "using a free, open-source library.");

            pres.save("quick-start.pptx", SaveFormat.PPTX);
        }
    }
}

تنسيقات مدعومة

وَالْمُتَّقِينَ SaveFormat يحدد القائمة كل تنسيق إخراج يمكن للمكتبة كتابته.الجدول أدناه يدرج الإدخالات المعتمدة.

ملاحظة : في الوقت الحاضر يتم تنفيذ فقط تصدير PPTX. قيمة تنسيق أخرى موجودة في SaveFormat أندية متوافقة مع التقدم ولكنها غير وظيفية بعد. save() الطريقة دائما تولد PPTX الناتج بغض النظر عن معيار الشكل.

المصدر المفتوح و الترخيص

Aspose.Slides FOSS for Java is distributed under the MIT license. The full source code is available on GitHub at Aspose.Slides-FOSS-for-Java.أنت حر في استخدام وتعديل وإعادة توزيع المكتبة في أي مشروع دون ملفات أو مفاتيح الترخيص.

بدءاً من

هل أنت مستعد للغوص أعمق؟ إليك الموارد التي تساعدك على البدء:

• دليل المطور - مسارات ومحاضرات لكل منطقة ميزة
• قاعدة المعرفة كيفية كتابة المقالات والأسئلة المتكررة
• إشارة API - الدرجة الكاملة و الوثائق الطريقة