فتح العروض التقديمية في Java

نظرة عامة

إلى جانب إنشاء عروض PowerPoint من الصفر، يتيح لك Aspose.Slides أيضًا فتح العروض التقديمية الموجودة. بعد تحميل العرض التقديمي، يمكنك استخراج معلومات عنه، تعديل محتوى الشرائح، إضافة شرائح جديدة، إزالة الشرائح الحالية، والمزيد.

فتح العروض التقديمية

لفتح عرض تقديمي موجود، قم بإنشاء كائن من الفئة Presentation ومرر مسار الملف إلى منشئها.

يظهر المثال التالي بلغة Java كيفية فتح عرض تقديمي والحصول على عدد الشرائح فيه:

// إنشاء كائن من الفئة Presentation وتمرير مسار الملف إلى منشئها.
Presentation presentation = new Presentation("Sample.pptx");
try {
    // طباعة العدد الإجمالي للشرائح في العرض التقديمي.
    System.out.println(presentation.getSlides().size());
} finally {
    presentation.dispose();
}

فتح العروض التقديمية المحمية بكلمة مرور

عند الحاجة إلى فتح عرض تقديمي محمي بكلمة مرور، مرّر كلمة المرور عبر طريقة setPassword في الفئة LoadOptions لفك التشفير وتحميله. يوضح الكود التالي بلغة Java هذه العملية:

LoadOptions loadOptions = new LoadOptions();
loadOptions.setPassword("YOUR_PASSWORD");

Presentation presentation = new Presentation("Sample.pptx", loadOptions);
try {
    // تنفيذ العمليات على العرض التقديمي المفكوك.
} finally {
    presentation.dispose();
}

فتح العروض التقديمية الكبيرة

يوفر Aspose.Slides خيارات—خاصة طريقة getBlobManagementOptions في الفئة LoadOptions—لمساعدتك على تحميل العروض التقديمية ذات الحجم الكبير.

يظهر الكود التالي بلغة Java كيفية تحميل عرض تقديمي كبير (على سبيل المثال، 2 جيجابايت):

final String filePath = "LargePresentation.pptx";

LoadOptions loadOptions = new LoadOptions();
// Choose the KeepLocked behavior — سيظل ملف العرض مقفلًا طوال مدة
// كائن Presentation، ولكن لا يلزم تحميله في الذاكرة أو نسخه إلى ملف مؤقت.
loadOptions.getBlobManagementOptions().setPresentationLockingBehavior(PresentationLockingBehavior.KeepLocked);
loadOptions.getBlobManagementOptions().setTemporaryFilesAllowed(true);
loadOptions.getBlobManagementOptions().setMaxBlobsBytesInMemory(10 * 1024 * 1024); // 10 ميجابايت

Presentation presentation = new Presentation(filePath, loadOptions);
try {
    // تم تحميل العرض التقديمي الكبير ويمكن استخدامه، مع بقاء استهلاك الذاكرة منخفضًا.

    // قم بإجراء تغييرات على العرض التقديمي.
    presentation.getSlides().get_Item(0).setName("Large presentation");

    // احفظ العرض التقديمي إلى ملف آخر. يظل استهلاك الذاكرة منخفضًا خلال هذه العملية.
    presentation.save("LargePresentation-copy.pptx", SaveFormat.Pptx);

    // لا تقم بذلك! سيُرمى استثناء إدخال/إخراج لأن الملف مقفل حتى يتم تحرير كائن العرض التقديمي.
    //Files.delete(Paths.get(filePath));
} finally {
    presentation.dispose();
}

// لا بأس بأن تقوم بذلك هنا. الملف الأصلي لم يعد مقفلًا بواسطة كائن العرض التقديمي.
Files.delete(Paths.get(filePath));

التحكم في الموارد الخارجية

يوفر Aspose.Slides الواجهة IResourceLoadingCallback التي تتيح لك إدارة الموارد الخارجية. يوضح الكود التالي بلغة Java كيفية استخدام واجهة IResourceLoadingCallback:

LoadOptions loadOptions = new LoadOptions();
loadOptions.setResourceLoadingCallback(new ImageLoadingHandler());

Presentation presentation = new Presentation("Sample.pptx", loadOptions);

class ImageLoadingHandler implements IResourceLoadingCallback {
    public int resourceLoading(IResourceLoadingArgs args) {
        if (args.getOriginalUri().endsWith(".jpg")) {
            try {
                // تحميل صورة بديلة.
                byte[] imageData = Files.readAllBytes(new File("aspose-logo.jpg").toPath());
                args.setData(imageData);
                return ResourceLoadingAction.UserProvided;
            } catch (RuntimeException ex) {
                return ResourceLoadingAction.Skip;
            }  catch (IOException ex) {
                ex.printStackTrace();
            }
        } else if (args.getOriginalUri().endsWith(".png")) {
            // تعيين عنوان URL بديل.
            args.setUri("http://www.google.com/images/logos/ps_logo2.png");
            return ResourceLoadingAction.Default;
        }
        // تخطي جميع الصور الأخرى.
        return ResourceLoadingAction.Skip;
    }
}

تحميل العروض التقديمية دون كائنات ثنائية مدمجة

يمكن أن يحتوي عرض PowerPoint على الأنواع التالية من الكائنات الثنائية المدمجة:

باستخدام طريقة ILoadOptions.setDeleteEmbeddedBinaryObjects، يمكنك تحميل عرض تقديمي دون أي كائنات ثنائية مدمجة.

تُستخدم هذه الطريقة لإزالة المحتوى الثنائي المحتمل أن يكون ضارًا. يوضح الكود التالي بلغة Java كيفية تحميل عرض تقديمي دون أي محتوى ثنائي مدمج:

LoadOptions loadOptions = new LoadOptions();
loadOptions.setDeleteEmbeddedBinaryObjects(true);

Presentation presentation = new Presentation("malware.ppt", loadOptions);
try {
    // قم بتنفيذ العمليات على العرض التقديمي.
} finally {
    presentation.dispose();
}

الأسئلة المتكررة

كيف يمكنني معرفة أن الملف معطوب ولا يمكن فتحه؟

ستتلقى استثناءً يتعلق بالتحليل أو التحقق من صحة التنسيق أثناء التحميل. غالبًا ما تُشير هذه الأخطاء إلى بنية ZIP غير صالحة أو سجلات PowerPoint مكسورة.

ماذا يحدث إذا كانت الخطوط المطلوبة مفقودة عند الفتح؟

سيفتح الملف، ولكن قد يستبدل العرض/التصدير الخطوط لاحقًا. يمكنك تكوين استبدال الخطوط أو إضافة الخطوط المطلوبة إلى بيئة التشغيل.

ماذا عن الوسائط المدمجة (فيديو/صوت) عند الفتح؟

تصبح الوسائط متاحة كموارد للعرض التقديمي. إذا كانت الوسائط مُشار إليها عبر مسارات خارجية، تأكد من أن هذه المسارات قابلة للوصول في بيئتك؛ وإلا قد تُهمل أثناء العرض/التصدير.

إنشاء عرض تقديمي باستخدام Java فحص العرض التقديمي