Buka Presentasi dalam C++

Pendahuluan

Selain membuat presentasi PowerPoint dari awal, Aspose.Slides juga memungkinkan Anda membuka presentasi yang sudah ada. Setelah memuat sebuah presentasi, Anda dapat mengambil informasi tentangnya, mengedit konten slide, menambahkan slide baru, menghapus yang sudah ada, dan lain-lain.

Membuka Presentasi

Untuk membuka presentasi yang sudah ada, buat instance kelas Presentation dan berikan jalur file ke konstruktornya.

Contoh C++ berikut menunjukkan cara membuka sebuah presentasi dan mendapatkan jumlah slide-nya:

// Membuat instance kelas Presentation dan memberikan jalur file ke konstruktor-nya.
auto presentation = MakeObject<Presentation>(u"Sample.pptx");

// Menampilkan total jumlah slide dalam presentasi.
Console::WriteLine(presentation->get_Slides()->get_Count());

presentation->Dispose();

Membuka Presentasi yang Dilindungi Kata Sandi

Ketika Anda perlu membuka presentasi yang dilindungi kata sandi, berikan kata sandi melalui metode set_Password dari kelas LoadOptions untuk mendekripsi dan memuatnya. Kode C++ berikut mendemonstrasikan operasi ini:

auto loadOptions = MakeObject<LoadOptions>();
loadOptions->set_Password(u"YOUR_PASSWORD");

auto presentation = MakeObject<Presentation>(u"Sample.pptx", loadOptions);
    
// Lakukan operasi pada presentasi yang telah didekripsi.

presentation->Dispose();

Membuka Presentasi Besar

Aspose.Slides menyediakan opsi—terutama metode get_BlobManagementOptions di kelas LoadOptions—untuk membantu Anda memuat presentasi berukuran besar.

Kode C++ berikut menunjukkan cara memuat presentasi besar (misalnya, 2 GB):

auto filePath = u"LargePresentation.pptx";

auto loadOptions = MakeObject<LoadOptions>();
// Pilih perilaku KeepLocked—file presentasi akan tetap terkunci selama umur
// instansi Presentation, tetapi tidak perlu dimuat ke memori atau disalin ke file sementara.
loadOptions->get_BlobManagementOptions()->set_PresentationLockingBehavior(PresentationLockingBehavior::KeepLocked);
loadOptions->get_BlobManagementOptions()->set_IsTemporaryFilesAllowed(true);
loadOptions->get_BlobManagementOptions()->set_MaxBlobsBytesInMemory(10 * 1024 * 1024); // 10 MB

auto presentation = MakeObject<Presentation>(filePath, loadOptions);

// Presentasi besar telah dimuat dan dapat digunakan, sementara konsumsi memori tetap rendah.

// Lakukan perubahan pada presentasi.
presentation->get_Slide(0)->set_Name(u"Large presentation");

// Simpan presentasi ke file lain. Konsumsi memori tetap rendah selama operasi ini.
presentation->Save(u"LargePresentation-copy.pptx", SaveFormat::Pptx);

// Jangan lakukan ini! Eksepsi I/O akan dilempar karena file terkunci sampai objek presentasi dibuang.
File::Delete(filePath);

presentation->Dispose();

// Tidak apa-apa melakukannya di sini. File sumber tidak lagi terkunci oleh objek presentasi.
File::Delete(filePath);

Mengendalikan Sumber Daya Eksternal

Aspose.Slides menyediakan antarmuka IResourceLoadingCallback yang memungkinkan Anda mengelola sumber daya eksternal. Kode C++ berikut menunjukkan cara menggunakan antarmuka IResourceLoadingCallback:

class ImageLoadingHandler : public IResourceLoadingCallback
{
public:
    ResourceLoadingAction ResourceLoading(SharedPtr<IResourceLoadingArgs> args) override
    {
        if (args->get_OriginalUri().EndsWith(u".jpg"))
        {
            try
            {
                // Muat gambar pengganti.
                auto imageData = File::ReadAllBytes(u"aspose-logo.jpg");
                args->SetData(imageData);
                return ResourceLoadingAction::UserProvided;
            }
            catch (Exception&)
            {
                return ResourceLoadingAction::Skip;
            }
        }
        else if (args->get_OriginalUri().EndsWith(u".png"))
        {
            // Tetapkan URL pengganti.
            args->set_Uri(u"http://www.google.com/images/logos/ps_logo2.png");
            return ResourceLoadingAction::Default;
        }

        // Lewati semua gambar lainnya.
        return ResourceLoadingAction::Skip;
    }
};
auto loadOptions = MakeObject<LoadOptions>();
loadOptions->set_ResourceLoadingCallback(MakeObject<ImageLoadingHandler>());

auto presentation = MakeObject<Presentation>(u"Sample.pptx", loadOptions);

Muat Presentasi tanpa Objek Biner yang Disematkan

Presentasi PowerPoint dapat berisi jenis objek biner yang disematkan berikut:

Dengan menggunakan metode ILoadOptions::set_DeleteEmbeddedBinaryObjects, Anda dapat memuat sebuah presentasi tanpa objek biner yang disematkan.

Metode ini berguna untuk menghapus konten biner yang berpotensi berbahaya. Kode C++ berikut menunjukkan cara memuat sebuah presentasi tanpa konten biner yang disematkan:

auto loadOptions = MakeObject<LoadOptions>();
loadOptions->set_DeleteEmbeddedBinaryObjects(true);

auto presentation = MakeObject<Presentation>(u"malware.ppt", loadOptions);

// Perform operations on the presentation.

presentation->Dispose();

FAQ

Bagaimana saya dapat mengetahui bahwa sebuah file rusak dan tidak dapat dibuka?

Anda akan menerima pengecualian parsing/validasi format saat memuat. Kesalahan semacam itu sering menyebutkan struktur ZIP yang tidak valid atau rekaman PowerPoint yang rusak.

Apa yang terjadi jika font yang dibutuhkan tidak ada saat membuka?

File akan terbuka, tetapi kemudian rendering/export mungkin menggantikan font. Konfigurasikan substitusi font atau tambahkan font yang diperlukan ke lingkungan runtime.

Bagaimana dengan media yang disematkan (video/audio) saat membuka?

Mereka akan tersedia sebagai sumber daya presentasi. Jika media direferensikan melalui jalur eksternal, pastikan jalur tersebut dapat diakses di lingkungan Anda; bila tidak, rendering/export mungkin tidak menyertakan media tersebut.