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:

  1. Hozzon létre egy Presentation osztálypéldányt.
  2. Állítsa be a View Properties értékét a Presentation számára.
  3. Í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.