Prezentáció nézet tulajdonságainak lekérése és frissítése Pythonnal Java segítségével

Bevezetés

Normál nézet három tartalmi területet tartalmaz: a diát magát, egy oldali tartalmi területet és egy alsó tartalmi területet. A normál nézet tulajdonságai leírják ezen tartalmi területek elhelyezkedését. Ez az információ lehetővé teszi az alkalmazás számára, hogy elmentse a nézet állapotát a fájlba, így újranyitáskor a nézet ugyanabban az állapotban lesz, mint amikor a bemutatót legutóbb mentették.

A ViewProperties.getNormalViewProperties metódust adjuk hozzá, hogy hozzáférést biztosítson a bemutató normál nézet tulajdonságaihoz.

Hozzáadtuk a NormalViewProperties , NormalViewRestoredProperties osztályokat és a SplitterBarStateType felsorolást.

A NormalViewProperties osztályról

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

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

A getSnapVerticalSplitter és a setSnapVerticalSplitter metódusok határozzák meg, hogy a függőleges elválasztó sáv minimális állapotba álljon-e, amikor az oldalsó terület elég kicsi.

A getPreferSingleView és a setPreferSingleView metódusok határozzák meg, hogy a felhasználó inkább egy teljes ablakos, egyetlen tartalmi területet szeretne-e a három tartalmi területből álló szabványos normál nézet helyett. Engedélyezve az alkalmazás választhatja, hogy egy tartalmi területet jelenítsen meg az egész ablakban.

A getVerticalBarState és a getHorizontalBarState metódusok határozzák meg, hogy a vízszintes vagy függőleges elválasztó sáv melyik állapotban jelenjen meg. A vízszintes elválasztó sáv elválasztja a diát a diát 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 van alkalmazva a getVerticalBarState és a getHorizontalBarState metódusokra, illetve.

A NormalViewProperties helyreállításáról

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

A getDimensionSize metódus határozza meg a diaterület méretét (szélesség, ha a getRestoredTop gyermekeként, magasság, ha a getRestoredLeft gyermekeként).

A getAutoAdjust metódus határozza meg, hogy az oldalsó tartalmi terület mérete kompenzálja-e az új méretet, amikor az alkalmazáson belüli nézetablak méretét változtatják.

Az alábbi példa bemutatja, hogyan férhetünk hozzá a ViewProperties.getNormalViewProperties metódushoz egy bemutató esetén.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SplitterBarStateType

presentation = Presentation()
try:
    normal_view_properties = presentation.getViewProperties().getNormalViewProperties()
    normal_view_properties.setHorizontalBarState(SplitterBarStateType.Restored)
    normal_view_properties.setVerticalBarState(SplitterBarStateType.Maximized)

    # A bemutató nézet tulajdonságainak visszaállítása.
    normal_view_properties.getRestoredTop().setAutoAdjust(True)
    normal_view_properties.getRestoredTop().setDimensionSize(80)
    normal_view_properties.setShowOutlineIcons(True)

    presentation.save("presentation_normal_view_state.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Az alapértelmezett nagyítási érték beállítása

A nézet tulajdonságainak 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 Presentation View Properties értékét.
  3. Mentse a bemutatót PPTX fájlként.

Az alábbi példában beállítjuk a nagyítási értéket a dianézethez és a jegyzetnézethez egyaránt.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation()
try:
    # A bemutató nézet tulajdonságainak beállítása.
    presentation.getViewProperties().getSlideViewProperties().setScale(100)  # Nagyítási százalék a dianézethez.
    presentation.getViewProperties().getNotesViewProperties().setScale(100)  # Nagyítási százalék a jegyzet nézethez.

    presentation.save("Zoom_out.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

A rácstávolság beállítása

Használja a Presentation.getViewProperties metódust a bemutató szintű nézet beállítások eléréséhez. A ViewProperties.getGridSpacing és a ViewProperties.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 bemutatóra vonatkozik, nem egyetlen diára. A rácstávolság pontban van megadva, ahol 72 pont egy hüvelyknek felel meg. Pozitív értéket használjon, ahogy az API dokumentációja előírja.

A következő példa megnyit egy létező demo.pptx fájlt, kiírja a jelenlegi rácstávolságot, beállít egy negyed hüvelykes intervallumot, majd elmenti az eredményt.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("demo.pptx")
try:
    grid_spacing = presentation.getViewProperties().getGridSpacing()
    print(f"Current grid spacing: {grid_spacing} points")

    presentation.getViewProperties().setGridSpacing(18.0)
    presentation.save("grid-spacing.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

A rács különbözik a drawing guides-tól. A rácstávolság egy szabályos intervallumot szabályoz, míg a rajzolási segédvonalak egyesével elhelyezett vízszintes vagy függőleges igazítási vonalak. A segédvonalak hozzáadása, mozgatása vagy törlése nem változtatja meg a rácstávolságot.

A rács és a rajzolási segédvonalak egyaránt szerkesztési segédeszközök. Nem jelennek meg dia tartalomként PDF-ben, képekben, SVG-ben vagy diavetítésben. A rácstávolság tárolása nem garantálja, hogy a 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 a bemutató megnyitásakor

Használja a Presentation.getViewProperties metódust a bemutató szintű nézet beállítások eléréséhez. A ViewProperties.getShowComments és a ViewProperties.setShowComments segítségével olvashatja vagy módosíthatja a tárolt preferenciát, hogy a megjegyzéseket meg kell-e jeleníteni, amikor a bemutatót a PowerPoint vagy egy másik kompatibilis szerkesztő nyitja meg.

Ez a beállítás csak a tárolt nézetpreferenciát 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. Tekintse meg a Presentation Comments oldalt a megjegyzéseket módosító műveletekhez.

A következő példához egy meglévő, comments.pptx fájlra van szükség, amely tartalmaz megjegyzéseket. Kiírja a jelenlegi láthatósági beállítást, kéri a megjegyzések elrejtését, és egy új PPTX fájlt ment, anélkül hogy eltávolítana bármilyen megjegyzést. Emellett a ViewProperties.setLastView metódust a ViewType.SlideView értékkel használja a kezdeti szerkesztő nézet és a megjegyzések láthatóságának beállításához.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import NullableBool, Presentation, SaveFormat, ViewType

presentation = Presentation("comments.pptx")
try:
    show_comments = presentation.getViewProperties().getShowComments()
    print(f"Current comment visibility: {show_comments}")

    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 osztólagos exportokban. A megfelelő exportspecifikus beállításokat külön kell konfigurálni.

GYIK

Miért nem látható a rács, amikor újra megnyitom a bemutatót?
A fájl tárolja a rácstávolságot, de a szerkesztő szabályozza, hogy a rács megjelenik-e. Ellenőrizze a szerkesztő rács láthatósági beállításait.

A rajzolási segédvonalak törlése megváltoztatja a rácstávolságot?
Nem. A rajzolási segédvonalak és a rácstávolság független beállítások. A segédvonalak törlése nem változtatja meg a tárolt rácsintervallumot.

Beállíthatok különböző nézetbeállításokat a bemutató egyes szakaszaira?
A View settings a bemutató szinten vannak meghatározva (Normal View/Slide View), nem szekciónként, ezért egyetlen paraméterkészlet érvényes a teljes dokumentumra a megnyitáskor.

Előre definiálhatok különböző nézetá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 csak egy nézettulajdonság-készletet tartalmaz.

Elkészíthetek sablont előre definiált View Properties-szal, hogy az új bemutatók ugyanúgy nyíljanak meg?
Igen. Mivel a view properties a bemutató szinten vannak tárolva, beágyazhatja őket egy sablonba, és új dokumentumokat hozhat létre belőle ugyanazzal a kiinduló nézetkonfigurációval.

Prezentáció tulajdonságok kezelése Pythonban Prezentációs megjegyzések kezelése Pythonban Java-n keresztül