Mengambil dan Memperbarui Properti Tampilan Presentasi di Java

Tentang apa halaman ini

Temukan properti tampilan Aspose.Slides untuk Java untuk menyesuaikan format slide PPT, PPTX, dan ODP—atur tata letak, tingkat zoom, dan pengaturan tampilan.

Pendahuluan

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

MetodeIViewProperties.getNormalViewProperties telah ditambahkan untuk menyediakan akses ke properti tampilan normal presentasi.

AntarmukaINormalViewProperties,INormalViewRestoredProperties dan turunannya,SplitterBarStateType enum telah ditambahkan.

Tentang INormalViewProperties

Mewakili properti tampilan normal.

MetodegetShowOutlineIcons dansetShowOutlineIcons menentukan apakah aplikasi harus menampilkan ikon saat menampilkan konten outline di salah satu wilayah konten mode tampilan normal.

MetodegetSnapVerticalSplitter dansetSnapVerticalSplitter menentukan apakah pembagi vertikal harus menempel ke keadaan diperkecil ketika wilayah samping cukup kecil.

PropertigetPreferSingleView dansetPreferSingleView menentukan apakah pengguna lebih suka melihat satu wilayah konten penuh jendela dibandingkan tampilan normal standar dengan tiga wilayah konten. Jika diaktifkan, aplikasi dapat memilih untuk menampilkan salah satu wilayah konten di seluruh jendela.

MetodegetVerticalBarState dangetHorizontalBarState menentukan keadaan yang harus ditunjukkan oleh pembagi batang horizontal atau vertikal. Pembagi batang horizontal memisahkan slide dari wilayah konten di bawah slide, pembagi batang vertikal memisahkan slide dari wilayah konten samping. Nilai yang memungkinkan adalah:SplitterBarStateType.Minimized,SplitterBarStateType.MaximizeddanSplitterBarStateType.Restored.

MetodegetRestoredLeft dangetRestoredTop menentukan ukuran wilayah slide atas atau samping tampilan normal, ketika nilaiSplitterBarStateType.Restored diterapkan untukgetVerticalBarStatedangetHorizontalBarState secara sesuai.

Tentang Mengembalikan INormalViewProperties

Menentukan ukuran wilayah slide (lebar ketika anak darigetRestoredTop, tinggi ketika anak darigetRestoredLeft) tampilan normal, ketika wilayah tersebut memiliki ukuran dipulihkan yang variabel (tidak diperkecil maupun diperbesar).

MetodegetDimensionSize menentukan ukuran wilayah slide (lebar ketika anak dari restoredTop, tinggi ketika anak dari restoredLeft).

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

Contoh di bawah menunjukkan cara mengakses propertiViewProperties.getNormalViewProperties untuk sebuah presentasi.

import com.aspose.slides.*;

Presentation 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();
}

Mengatur Nilai Zoom Default

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

Untuk mengatur properti tampilan, ikuti langkah-langkah berikut:

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

import com.aspose.slides.*;

Presentation 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();
}

Mengatur Jarak Grid

GunakanPresentation.getViewProperties untuk mengakses pengaturan tampilan pada seluruh presentasi. MetodeIViewProperties.getGridSpacing danIViewProperties.setGridSpacing membaca atau mengubah interval grid penyuntingan yang mendasarinya. Pengaturan ini berlaku untuk seluruh presentasi, bukan untuk slide individu. Jarak grid ditentukan dalam poin, di mana 72 poin sama dengan satu inci. Gunakan nilai positif, sesuai dokumentasi API.

Contoh berikut membuka demo.pptx yang ada, mencetak jarak grid saat ini, mengatur interval seperempat inci, dan menyimpan hasilnya.

import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation("demo.pptx");
try {
    float gridSpacing = presentation.getViewProperties().getGridSpacing();
    System.out.println("Current grid spacing: " + gridSpacing + " points");

    presentation.getViewProperties().setGridSpacing(18f);
    presentation.save("grid-spacing.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Grid berbeda daridrawing guides. Jarak grid mengontrol interval reguler, sementara drawing guides adalah garis penyelarasan horizontal atau vertikal yang diposisikan secara individual. Menambah, memindahkan, atau menghapus drawing guides tidak mengubah jarak grid.

Baik grid maupun drawing guides merupakan bantuan penyuntingan. Mereka tidak dirender sebagai konten slide dalam PDF, gambar, SVG, atau tayangan slide. Menyimpan jarak grid tidak menjamin editor akan menampilkan grid: visibilitasnya juga bergantung pada preferensi penampil atau editor.

Menampilkan atau Menyembunyikan Komentar Saat Membuka Presentasi

GunakanPresentation.getViewProperties untuk mengakses pengaturan tampilan pada seluruh presentasi. GunakanIViewProperties.getShowComments danIViewProperties.setShowComments untuk membaca atau mengubah preferensi yang disimpan mengenai apakah komentar harus ditampilkan saat presentasi dibuka di PowerPoint atau editor kompatibel lainnya.

Pengaturan ini hanya mengontrol preferensi tampilan yang disimpan. Ia tidak menambah, menghapus, menyunting, atau menyelesaikan komentar. Menyembunyikan komentar mempertahankan konten, penulis, posisi, balasan, dan statusnya. LihatPresentation Comments untuk operasi yang mengubah komentar itu sendiri.

Contoh berikut memerlukan comments.pptx yang sudah ada berisi komentar. Ia mencetak pengaturan visibilitas saat ini, meminta komentar disembunyikan, dan menyimpan PPTX baru tanpa menghapus komentar apa pun. Ia juga menggunakanIViewProperties.setLastView denganViewType.SlideView untuk mengonfigurasi tampilan penyuntingan awal bersamaan dengan visibilitas komentar.

import com.aspose.slides.NullableBool;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
import com.aspose.slides.ViewType;

Presentation presentation = new Presentation("comments.pptx");
try {
    byte showComments = presentation.getViewProperties().getShowComments();
    System.out.println("Current comment visibility: " + showComments);

    presentation.getViewProperties().setShowComments(NullableBool.False);
    presentation.getViewProperties().setLastView(ViewType.SlideView);
    presentation.save("comments-hidden.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Pengaturan ini tidak menentukan apakah komentar termasuk dalam ekspor PDF, HTML, gambar, catatan, atau handout. Konfigurasikan opsi spesifik ekspor yang relevan secara terpisah.

FAQ

Mengapa grid tidak terlihat setelah saya membuka kembali presentasi?

File menyimpan jarak grid, tetapi editor yang mengontrol apakah grid ditampilkan. Periksa pengaturan visibilitas grid pada editor.

Apakah menghapus drawing guides mengubah jarak grid?

Tidak. Drawing guides dan jarak grid merupakan pengaturan yang independen. Menghapus guides tidak mengubah interval grid yang disimpan.

Bisakah saya menetapkan pengaturan tampilan yang berbeda untuk bagian berbeda dari sebuah presentasi?

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

Bisakah saya mendefinisikan 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 berisi satu set properti tampilan.

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

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

Kelola Properti Presentasi di Java Kelola Komentar Presentasi di Java