Prezentációs nézet tulajdonságok lekérése és frissítése Java-ban

Bevezetés

A normál nézet három tartalmi területből áll: maga a dia, egy oldalsó tartalmi terület, és egy alsó tartalmi terület. Tulajdonságok, amelyek a különböző tartalmi területek elhelyezkedésére vonatkoznak. Ez az információ lehetővé teszi az alkalmazás számára, hogy a nézeti állapotot a fájlba mentse, így a megnyitáskor a nézet ugyanabban az állapotban lesz, mint amikor a prezentációt utoljára mentették.

A IViewProperties.getNormalViewProperties metódus hozzá lett adva, hogy hozzáférést biztosítson a prezentáció normál nézet tulajdonságaihoz.

[INormalViewProperties], [INormalViewRestoredProperties] interfészek és azok leszármazottjai, valamint a SplitterBarStateType enum hozzá lettek adva.

Az INormalViewProperties-ról

A normál nézet tulajdonságait képviseli.

A getShowOutlineIcons és a setShowOutlineIcons metódusok meghatározzák, hogy az alkalmazás mutasson-e ikonokat, ha a vázlat tartalmat jeleníti meg a normál nézet bármelyik tartalmi területén.

A getSnapVerticalSplitter és a setSnapVerticalSplitter metódusok meghatározzák, hogy a függőleges osztó rács a kis méretű oldalsó terület esetén minimalizált állapotba illeszkedjen-e.

A getPreferSingleView és a setPreferSingleView tulajdonságok meghatározzák, hogy a felhasználó a három tartalmi területtel rendelkező standard normál nézet helyett teljesablakos, egyetlen tartalmi területtel szeretné-e látni a nézetet. Ha engedélyezve van, az alkalmazás megjelenítheti a tartalmi területek egyikét az egész ablakban.

A getVerticalBarState és a getHorizontalBarState metódusok meghatározzák, hogy a vízszintes vagy függőleges elosztó sáv milyen állapotban jelenjen meg. A vízszintes elosztó sáv elválasztja a diát a diától alul lévő tartalmi területtől, a függőleges elosztó sáv pedig 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 határozzák meg a felső vagy oldalsó diaterület méretét a normál nézetben, amikor a SplitterBarStateType.Restored érték van alkalmazva a getVerticalBarState és a getHorizontalBarState megfelelően.

Az INormalViewProperties visszaállítása

Meghatározza a diaterület méretét (szélesség, ha a getRestoredTop gyermekeként, magasság, ha a getRestoredLeft gyermekeként) a normál nézetben, amikor a terület változó visszaállított mérettel rendelkezik (sem minimalizált, sem maximalizált).

A getDimensionSize metódus meghatározza a diaterület méretét (szélesség, ha a restoredTop gyermekeként, magasság, ha a restoredLeft gyermekeként).

A getAutoAdjust metódus meghatározza, hogy a side content terület mérete kompenzálja-e az új méretet, amikor az alkalmazáson belüli nézetet tartalmazó ablak méretét változtatják.

Az alábbi példa bemutatja, hogyan férhet hozzá a ViewProperties.getNormalViewProperties tulajdonságaihoz egy prezentáció esetén.

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

Alapértelmezett nagyítás beállítása

A nézeti tulajdonságok beállításához kövesse az alábbi lépéseket:

  1. Hozzon létre egy példányt a Presentation osztályból.
  2. Állítsa be a View Properties a Presentation számára.
  3. Mentse a prezentációt PPTX fájlként. Az alább bemutatott példában beállítottuk a nagyítási értéket a dia nézeti és a jegyzet nézeti módhoz is.
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();
}

FAQ

Beállíthatok különböző nézeti beállításokat a prezentáció különböző szekcióihoz?

A nézeti beállítások a prezentáció szintjén vannak definiálva (Normál nézet/Dia nézet), nem szekciónként, ezért egyetlen paraméterkészlet alkalmazandó a teljes dokumentumra a megnyitáskor.

Előre meghatározhatok 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 tárolódnak és megosztottak. A megjelenítő alkalmazások figyelembe vehetik a felhasználói preferenciákat, de magában a fájl csak egyetlen nézeti tulajdonság‑készletet tartalmaz.

Elkészíthetek egy sablont előre meghatározott nézeti tulajdonságokkal, hogy az új prezentációk ugyanúgy nyíljanak meg?

Igen. Mivel a view properties a prezentáció szintjén tárolódnak, beágyazhatók egy sablonba, és új dokumentumok létrehozhatók ebből ugyanazzal a kezdeti nézeti konfigurációval.