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

نظرة عامة

بعيدًا عن إنشاء عروض 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();
// اختر سلوك KeepLocked—ملف العرض سيبقى مقفلًا طوال مدة
// كائن 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);

    // لا تفعل ذلك! سيُرمى استثناء I/O لأن الملف مقفل حتى يتم التخلص من كائن العرض.
    //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 = getImageBytes("aspose-logo.jpg"); // استخدم أي طريقة للحصول على البايتات
                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 مكسورة.

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

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

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

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

إنشاء عروض تقديمية على Android استرجاع وتحديث معلومات العرض التقديمي على أندرويد