Ambil dan Perbarui Properti Tampilan Presentasi di PHP

Pendahuluan

Tampilan normal terdiri dari tiga wilayah konten: slide itu sendiri, wilayah konten samping, dan wilayah konten bagian bawah. Properti yang berkaitan dengan penempatan berbagai wilayah konten. Informasi ini memungkinkan aplikasi menyimpan status tampilan ke file, sehingga saat dibuka kembali tampilan berada dalam kondisi yang sama seperti saat presentasi terakhir disimpan.

Metode ViewProperties::getNormalViewProperties telah ditambahkan untuk memberikan akses ke properti tampilan normal presentasi.

Kelas NormalViewProperties, NormalViewRestoredProperties dan turunannya, serta enum SplitterBarStateType telah ditambahkan.

Tentang INormalViewProperties

Mewakili properti tampilan normal.

Metode getShowOutlineIcons dan setShowOutlineIcons menentukan apakah aplikasi harus menampilkan ikon ketika menampilkan konten outline di salah satu wilayah konten mode tampilan normal.

Metode getSnapVerticalSplitter dan setSnapVerticalSplitter menentukan apakah pembagi vertikal harus menempel ke keadaan diperkecil ketika wilayah samping cukup kecil.

Properti getPreferSingleView dan setPreferSingleView menentukan apakah pengguna lebih suka melihat satu wilayah konten penuh‑jendela dibandingkan tampilan normal standar dengan tiga wilayah konten. Jika diaktifkan, aplikasi dapat memilih menampilkan salah satu wilayah konten di seluruh jendela.

Metode getVerticalBarState dan getHorizontalBarState menentukan keadaan yang harus ditampilkan oleh bilah pemisah horizontal atau vertikal. Bilah pemisah horizontal memisahkan slide dari wilayah konten di bawah slide, bilah pemisah vertikal memisahkan slide dari wilayah konten samping. Nilai yang mungkin adalah: SplitterBarStateType::Minimized, SplitterBarStateType::Maximized dan SplitterBarStateType::Restored.

Metode getRestoredLeft dan getRestoredTop menentukan ukuran wilayah slide atas atau samping pada tampilan normal, ketika nilai SplitterBarStateType::Restored diterapkan pada getVerticalBarState dan getHorizontalBarState secara bersamaan.

Tentang Memulihkan INormalViewProperties

Menentukan ukuran wilayah slide (lebar ketika menjadi anak dari getRestoredTop, tinggi ketika menjadi anak dari getRestoredLeft) pada tampilan normal, ketika wilayah tersebut memiliki ukuran pemulihan variabel (tidak diperkecil maupun diperbesar).

Metode getDimensionSize menentukan ukuran wilayah slide (lebar ketika menjadi anak dari restoredTop, tinggi ketika menjadi anak dari restoredLeft).

Metode getAutoAdjust menentukan apakah ukuran wilayah konten samping harus menyesuaikan ukuran baru saat mengubah ukuran jendela yang berisi tampilan dalam aplikasi.

Contoh di bawah menunjukkan bagaimana Anda dapat mengakses properti ViewProperties::getNormalViewProperties untuk sebuah presentasi.

  $pres = new Presentation();
  try {
    $pres->getViewProperties()->getNormalViewProperties()->setHorizontalBarState(SplitterBarStateType::Restored);
    $pres->getViewProperties()->getNormalViewProperties()->setVerticalBarState(SplitterBarStateType::Maximized);

    # Pulihkan properti tampilan presentasi
    $pres->getViewProperties()->getNormalViewProperties()->getRestoredTop()->setAutoAdjust(true);
    $pres->getViewProperties()->getNormalViewProperties()->getRestoredTop()->setDimensionSize(80);
    $pres->getViewProperties()->getNormalViewProperties()->setShowOutlineIcons(true);
    $pres->save("presentation_normal_view_state.pptx", SaveFormat::Pptx);
  } finally {
    $pres->dispose();
  }

Setel Nilai Zoom Default

Aspose.Slides untuk PHP via Java kini mendukung penetapan nilai zoom default untuk presentasi sehingga ketika presentasi dibuka, zoom sudah diatur. Hal ini dapat dilakukan dengan mengatur ViewProperties dari sebuah presentasi. getSlideViewProperties serta getNotesViewProperties dapat diatur secara programatis. Pada topik ini, kita akan melihat dengan contoh cara mengatur View Properties dari Presentation di Aspose.Slides.

Untuk mengatur properti tampilan, ikuti langkah‑langkah berikut:

1. Buat sebuah instance kelas Presentation.
2. Atur View Properties dari Presentation.
3. Simpan presentasi sebagai file PPTX. Pada contoh di bawah, kami telah mengatur nilai zoom untuk tampilan slide serta tampilan catatan.

  $presentation = new Presentation();
  try {
    # Mengatur properti tampilan presentasi
    $presentation->getViewProperties()->getSlideViewProperties()->setScale(100); // Nilai zoom dalam persentase untuk tampilan slide
    $presentation->getViewProperties()->getNotesViewProperties()->setScale(100); // Nilai zoom dalam persentase untuk tampilan catatan

    $presentation->save("Zoom_out.pptx", SaveFormat::Pptx);
  } finally {
    $presentation->dispose();
  }

FAQ

Apakah saya dapat mengatur pengaturan tampilan yang berbeda untuk bagian‑bagian yang berbeda dari sebuah presentasi?

Pengaturan tampilan didefinisikan pada tingkat presentasi (Normal View/Slide View), tidak per bagian, sehingga satu set parameter berlaku untuk seluruh dokumen saat dibuka.

Apakah saya dapat menetapkan sebelumnya keadaan tampilan yang berbeda untuk pengguna yang berbeda?

Tidak. Pengaturan disimpan dalam file dan bersifat bersama. Aplikasi penampil mungkin menghormati preferensi pengguna, tetapi file itu sendiri hanya berisi satu set properti tampilan.

Apakah saya dapat menyiapkan templat dengan View Properties yang telah ditentukan sebelumnya sehingga presentasi baru terbuka dengan cara yang sama?

Ya. Karena view properties disimpan pada tingkat presentasi, Anda dapat menyematkannya dalam templat dan membuat dokumen baru darinya dengan konfigurasi tampilan awal yang sama.