Prezentáció nézet tulajdonságainak lekérése és frissítése Java-ban
Bevezetés
A normál nézet három tartalmi területből áll: a diából, egy oldalsó tartalmi területből és egy alsó tartalmi területből. A különböző tartalmi területek elhelyezésével kapcsolatos tulajdonságok. Ezek az információk lehetővé teszik az alkalmazás számára, hogy a nézet állapotát a fájlba mentse, így újra megnyitáskor a nézet ugyanabban az állapotban lesz, mint amikor a bemutatót legutóbb mentették.
A IViewProperties.getNormalViewProperties metódust hozzáadtuk, hogy hozzáférést biztosítson a bemutató normál nézetének tulajdonságaihoz.
Hozzáadtuk az INormalViewProperties, INormalViewRestoredProperties interfészeket és azok leszármazottjait, valamint a SplitterBarStateType felsoroló típust.
Az INormalViewProperties
A normál nézet tulajdonságait képviseli.
A getShowOutlineIcons és a setShowOutlineIcons metódusok meghatározzák, hogy az alkalmazás ikonokat jelenítsen-e meg, ha a normál nézet bármely tartalmi területén vázlatot jelenít meg.
A getSnapVerticalSplitter és a setSnapVerticalSplitter metódusok meghatározzák, hogy a függőleges elválasztó a mellékleges terület elég kicsi leszésekor minimalizált állapotba ragadjon-e.
A getPreferSingleView és a setPreferSingleView tulajdonságok meghatározzák, hogy a felhasználó egy teljes ablakos, egyetlen tartalmi területet részesít-e előnyben a három tartalmi területet tartalmazó szabványos normál nézethez képest. Ha engedélyezve van, az alkalmazás egyik tartalmi területet is megjelenítheti az egész ablakban.
A getVerticalBarState és a getHorizontalBarState metódusok meghatározzák, hogy a vízszintes vagy függőleges elválasztó sáv milyen állapotban legyen megjelenítve. A vízszintes elválasztó sáv elválasztja a diát a diák alatti tartalmi területtől, a függőleges elválasztó sáv elválasztja a diát az oldalsó tartalmi területtől. Lehetséges értékek: SplitterBarStateType.Minimized, SplitterBarStateType.Maximized és SplitterBarStateType.Restored.
A getRestoredLeft és a getRestoredTop metódusok meghatározzák a normál nézet felső vagy oldalsó diaterületének méretét, amikor a SplitterBarStateType.Restored érték alkalmazásra kerül a getVerticalBarState és a getHorizontalBarState esetén.
Az INormalViewProperties helyreállítása
Meghatározza a normál nézet diaterületének méretét (szélesség, ha a getRestoredTop gyermekéről van szó, magasság, ha a getRestoredLeft gyermekéről van szó), amikor a terület változó helyreállított méretekkel rendelkezik (sem minimalizált, sem maximalizált).
A getDimensionSize metódus a diaterület méretét adja meg (szélesség a restoredTop esetén, magasság a restoredLeft esetén).
A getAutoAdjust metódus meghatározza, hogy az oldalsó tartalmi terület mérete kompenzálja-e az új méretet a nézetet tartalmazó ablak átméretezésekor az alkalmazáson belül.
Az alább bemutatott példa azt mutatja, hogyan érheti el a ViewProperties.getNormalViewProperties tulajdonságait egy bemutató számára.
import com.aspose.slides.*;
Presentation pres = new Presentation();
try {
pres.getViewProperties().getNormalViewProperties().setHorizontalBarState(SplitterBarStateType.Restored);
pres.getViewProperties().getNormalViewProperties().setVerticalBarState(SplitterBarStateType.Maximized);
// A prezentáció nézet tulajdonságainak visszaállítása
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();
}
Az alapértelmezett nagyítási érték beállítása
A nézet tulajdonságok beállításához kövesse az alábbi lépéseket:
- Hozzon létre egy Presentation osztálypéldányt.
- Állítsa be a View Properties értékét a Presentation számára.
- Írja ki a prezentációt egy PPTX fájlként. Az alább látható példában beállítottuk a nagyítási értéket a dia- és a jegyzetnézethez is.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
// A prezentáció nézet tulajdonságainak beállítása
presentation.getViewProperties().getSlideViewProperties().setScale(100); // Nagyítási érték százalékban a dia nézethez
presentation.getViewProperties().getNotesViewProperties().setScale(100); // Nagyítási érték százalékban a jegyzet nézethez
presentation.save("Zoom_out.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
A rács távolság beállítása
Használja a Presentation.getViewProperties metódust a prezentáció szintű nézeti beállítások eléréséhez. Az IViewProperties.getGridSpacing és az IViewProperties.setGridSpacing metódusok olvassák vagy módosítják az alaprendszer szerkesztő rácsának intervallumát. Ez a beállítás a teljes prezentációra vonatkozik, nem egyetlen diara. A rács távolságát pontban adjuk meg, ahol 72 pont egy hüvelyknek felel meg. Pozitív értéket használjon, ahogy azt az API dokumentációja előírja.
Az alábbi példa megnyit egy meglévő demo.pptx fájlt, kiírja a jelenlegi rács távolságát, egy negyed hüvelykes intervallumra állítja, majd elmenti az eredményt.
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();
}
A rács különbözik a drawing guides útmutatóktól. A rács távolsága egy szabályos intervallumot szabályoz, míg a rajzoló útmutatók egyenként elhelyezett vízszintes vagy függőleges igazítási vonalak. Útmutatók hozzáadása, mozgatása vagy törlése nem változtatja meg a rács távolságát.
Mind a rács, mind a rajzoló útmutatók szerkesztési segédeszközök. Nem jelennek meg dia tartalomként PDF‑ben, képekben, SVG‑ben vagy diavetítésben. A rács távolságának tárolása nem garantálja, hogy egy szerkesztő megjeleníti a rácsot: láthatósága a megjelenítő vagy szerkesztő beállításaitól is függ.
Megjegyzések megjelenítése vagy elrejtése bemutató megnyitásakor
Használja a Presentation.getViewProperties metódust a prezentáció szintű nézeti beállítások eléréséhez. A IViewProperties.getShowComments és a IViewProperties.setShowComments segítségével olvashatja vagy módosíthatja a tárolt beállítást arról, hogy a megjegyzéseket meg kell‑e jeleníteni a PowerPoint vagy más kompatibilis szerkesztő megnyitásakor.
Ez a beállítás csak a tárolt nézeti előnyben részesítést szabályozza. Nem ad hozzá, nem távolít el, nem szerkeszt és nem old meg megjegyzéseket. A megjegyzések elrejtése megőrzi azok tartalmát, szerzőit, pozícióit, válaszait és állapotát. Lásd a Presentation Comments oldalt a megjegyzéseken végzett műveletekért.
Az alábbi példához egy meglévő comments.pptx fájl szükséges, amely megjegyzéseket tartalmaz. Kiírja a jelenlegi láthatósági beállítást, elrejti a megjegyzéseket, és egy új PPTX‑et ment anélkül, hogy a megjegyzéseket eltávolítaná. Emellett a IViewProperties.setLastView metódust a ViewType.SlideView értékkel használja a kezdeti szerkesztő nézet és a megjegyzés‑láthatóság konfigurálásához.
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();
}
Ez a beállítás nem határozza meg, hogy a megjegyzések szerepelnek‑e a PDF, HTML, kép, jegyzet vagy szórólap exportokban. A megfelelő export‑specifikus beállításokat külön kell konfigurálni.
GYIK
Miért nem látható a rács a bemutató újranyitása után?
A fájl tárolja a rács távolságát, de a szerkesztő szabályozza, hogy a rács megjelenjen‑e. Ellenőrizze a szerkesztő rács láthatósági beállításait.
A rajzoló útmutatók törlése megváltoztatja‑e a rács távolságát?
Nem. A rajzoló útmutatók és a rács távolsága független beállítások. Az útmutatók törlése nem módosítja a tárolt rács intervallumát.
Beállíthatok‑e különböző nézeti beállításokat a prezentáció különböző szekcióihoz?
A View settings a prezentáció szintjén (Normál nézet / Dia nézet) kerülnek definiálásra, nem szekciónként, így egyetlen paraméterkészlet vonatkozik a dokumentum egészére megnyitáskor.
Előre definiálhatok‑e különböző nézeti állapotokat különböző felhasználók számára?
Nem. A beállítások a fájlban vannak tárolva és megosztottak. A megjelenítő alkalmazások tiszteletben tarthatják a felhasználói preferenciákat, de a fájl önmagában csak egy nézet tulajdonságkészletet tartalmaz.
Készíthetek‑e sablont előre definiált View Properties‑sal, hogy az új prezentációk ugyanúgy nyíljanak meg?
Igen. Mivel a view properties a prezentáció szintjén vannak tárolva, beágyazhatsz őket egy sablonba, és új dokumentumokat hozhatsz létre belőle ugyanazzal a kezdeti nézeti konfigurációval.