Dia masterek kezelése Pythonon keresztül Java-val

Miről szól ez az oldal

Dia masterek kezelése az Aspose.Slides Python verziójában Java használatával: hozzáférés, szerkesztés, klónozás, összehasonlítás és master diák eltávolítása PowerPoint és OpenDocument prezentációkban.

Áttekintés

A slide master meghatározza a közös tervezési beállításokat egy diacsoport számára. Tartalmazhat közös alakzatokat, logókat, háttereket, szövegstílusokat, téma beállításokat és lábléc beállításokat. A PowerPointban a slide master szerkesztése a szokásos módja annak, hogy a prezentáció konzisztens maradjon anélkül, hogy minden dián ismételni kellene ugyanazt a formázást.

Aspose.Slides for Python via Java támogatja ugyanazt a modellt. Egy prezentáció tartalmazhat egy vagy több master diát, és minden master dia több layout diát is tartalmazhat. A normál diák általában nem hivatkoznak közvetlenül egy master diára. Ehelyett egy normál dia egy layout diát használ, amely egy master dia része.

A hierarchia a következő:

Slide master – meghatározza a közös tervezést és a témát.
Layout slide – meghatároz egy konkrét elrendezést a helyőrzőkkel és a layout szintű formázással.
Normal slide – tartalmazza a tényleges prezentációs tartalmat, és egy layout slide-ot használ.

A master diák, layout diák és normál diák hierarchiája

Az Aspose.Slides-ban a slide master a MasterSlide osztállyal van reprezentálva. A prezentáció összes master diája a Presentation.getMasters gyűjteményen keresztül érhető el, amelyet a MasterSlideCollection reprezentál.

Inheritance

Ha ugyanaz a tulajdonság több szinten is definiálva van, a specifikusabb szint nyer. Például, ha egy master dia és egy layout dia is meghatároz egy háttérszínt, a layoutra épülő diák a layout háttérét használják. További információért a layout diákról lásd a Apply or Change Slide Layouts oldalt.

A slide master-ek elérése

A PowerPointban a Slide Master nézetet a View > Slide Master menüből nyithatja meg.

A Slide Master parancs a PowerPoint Nézet lapon

Az Aspose.Slides-ban használja a Presentation.getMasters gyűjteményt a master diák eléréséhez:

import jpype
import asposeslides

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

from asposeslides.api import Presentation

presentation = Presentation("presentation.pptx")
try:
    first_master_slide = presentation.getMasters().get_Item(0)
    master_slide_count = presentation.getMasters().size()
    first_master_layout_slide_count = first_master_slide.getLayoutSlides().size()

    print(f"Master slides: {master_slide_count}")
    print(f"Layouts in the first master: {first_master_layout_slide_count}")
finally:
    presentation.dispose()

Le is kérheti egy normál dia által használt master diát a layoutján keresztül:

import jpype
import asposeslides

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

from asposeslides.api import Presentation

presentation = Presentation("presentation.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    layout_slide = slide.getLayoutSlide()
    master_slide = layout_slide.getMasterSlide()
    master_slide_name = master_slide.getName()

    print(master_slide_name)
finally:
    presentation.dispose()

Mit tartalmaz egy slide master

A master dia egy diára hasonlító objektum. Örökli a BaseSlide osztályt, így sok olyan dia tulajdonságot tesz elérhetővé, amelyet a normál és a layout diák használnak. A master specifikus tagok a MasterSlide API oldalán vannak felsorolva.

Az általánosan használt master dia tagok a következők:

Tag	Cél
getBackground	Beállítja a master szintű dia háttérét.
getShapes	A master-re helyezett alakzatokat tárolja, például logókat, képkockákat és megosztott szöveget.
getLayoutSlides	A masterhez tartozó layout diákat tárolja.
getThemeManager	Hozzáférést biztosít a master téma API-khoz.
getHeaderFooterManager	A master és annak alatti layoutok fejlécét, láblécét, dátumát és dia számait kezeli.
getDependingSlides	Visszaadja a normál diákat, amelyek a master-re a layoutjaikon keresztül támaszkodnak.

Kép hozzáadása egy slide master-hez

Ha képet ad hozzá egy master diához, az megjelenik azokon a diákon, amelyek az adott master layoutjait használják. Ez hasznos logók, vízjelek, díszcsíkok és egyéb ismétlődő vizuális elemek esetén.

A következő példa egy logót ad az első master diához:

import jpype
import asposeslides

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

from asposeslides.api import Images, Presentation, SaveFormat, ShapeType

presentation = Presentation("presentation.pptx")
try:
    master_slide = presentation.getMasters().get_Item(0)
    logo = Images.fromFile("logo.png")
    try:
        logo_image = presentation.getImages().addImage(logo)
        master_slide.getShapes().addPictureFrame(ShapeType.Rectangle, 20, 20, 80, 80, logo_image)
    finally:
        logo.dispose()

    presentation.save("presentation-with-logo.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

További információért a képkockákról lásd a Picture Frame oldalt.

A master grafikák láthatóságának vezérlése

A BaseSlide.setShowMasterShapes használatával elrejtheti az örökölt master grafikákat, például logókat vagy díszalakzatokat, anélkül, hogy a masterről törölné őket. Adjon False értéket a Slide.setShowMasterShapes metódusnak azon dián, amelyik el akarja hagyni ezeket a grafikákat, és True értéket azoknál a diáknál, amelyek meg akarják jeleníteni őket.

A következő önálló példa egy kék díszcsíkot hoz létre egy masteren, valamint két diát, amelyek ugyanazt az üres layoutot használják. A csík az első dián látható, a másodikon rejtett. Nem szükséges bemeneti prezentáció vagy kép.

import jpype
import asposeslides

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

from asposeslides.api import FillType, Presentation, SaveFormat, ShapeType, SlideLayoutType

Color = jpype.JClass("java.awt.Color")

presentation = Presentation()
try:
    master_slide = presentation.getMasters().get_Item(0)
    layout_slide = master_slide.getLayoutSlides().getByType(SlideLayoutType.Blank)
    layout_slide.setShowMasterShapes(True)

    slide_height = jpype.JFloat(presentation.getSlideSize().getSize().getHeight())
    band = master_slide.getShapes().addAutoShape(ShapeType.Rectangle, 0, 0, 60, slide_height)
    band_color = Color(70, 130, 180)
    band.getFillFormat().setFillType(FillType.Solid)
    band.getFillFormat().getSolidFillColor().setColor(band_color)
    band.getLineFormat().getFillFormat().setFillType(FillType.NoFill)

    visible_slide = presentation.getSlides().get_Item(0)
    visible_slide.setLayoutSlide(layout_slide)
    visible_slide.getShapes().clear()

    hidden_slide = presentation.getSlides().addEmptySlide(layout_slide)

    visible_slide.setShowMasterShapes(True)
    hidden_slide.setShowMasterShapes(False)

    presentation.save("master-graphics.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

A példa a Blank layoutot használja, amely egy új prezentációval érkezik, és eltávolítja az első dia saját helyőrzőit.

Válassza ki a beállítás hatókörét

Egy normál dia a masterét a Slide.getLayoutSlide és a LayoutSlide.getMasterSlide segítségével használja. A tulajdonság beállítása egy egyedi dián csak arra a diára hat. False átadása a LayoutSlide.setShowMasterShapes metódusnak elrejti a master grafikákat azokon a diákon, amelyek ezt a közös layoutot használják, még akkor is, ha a saját beállításuk True. Egyetlen dián történő grafika elrejtéséhez módosítsa a dia tulajdonságát, és hagyja változatlanul a közös layoutot.

A beállítás nem támogatott láthatóságvezérlőként a master dián magán. Egy masteren a getShowMasterShapes mindig False értéket ad vissza, és a setShowMasterShapes True értékének átadása kivételt generál. Inkább egy normál diára vagy egy layoutra alkalmazza.

Különböztesse meg a grafikát a háttértől

Művelet	Hatás
Az örökölt master alakzatok láthatóságának vezérlése, anélkül hogy törölné őket vagy módosítaná a dia saját alakzatait.
Megváltoztatja a dia háttérkitöltését	Megváltoztatja a háttér színét, gradiensét vagy képét. A master grafikák különálló alakzatok, és láthatóak maradhatnak a háttér felett. Lásd a Presentation Background oldalt.
Törölje egy alakzatot a masterről	Eltávolítja a megosztott forrás alakzatot, így már nem érhető el egyetlen diának sem, amely azt a mastert használja.

Helyőrzőkkel való munka

A helyőrzőket általában a layout diákon definiálják. A master dia biztosítja a közös stílust és temát, amelyet a layoutok örökölnek, míg minden layout eldönti, hogy melyik helyőrző elérhető és hol helyezkedik el.

A PowerPointban a helyőrző parancsok a Slide Master nézetben érhetők el.

A Helyőrző beszúrása parancs a PowerPoint Slide Master nézetben

Új helyőrzők hozzáadásához az Aspose.Slides használatával dolgozzon a masterhez tartozó layout diával:

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, SlideLayoutType

presentation = Presentation("presentation.pptx")
try:
    master_slide = presentation.getMasters().get_Item(0)
    blank_layout_slide = master_slide.getLayoutSlides().getByType(SlideLayoutType.Blank)

    if blank_layout_slide is None:
        blank_layout_slide = master_slide.getLayoutSlides().add(SlideLayoutType.Blank, "Blank")

    blank_layout_slide.getPlaceholderManager().addTextPlaceholder(60, 120, 600, 80)

    presentation.getSlides().addEmptySlide(blank_layout_slide)
    presentation.save("presentation-with-placeholder.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Megformázhatja a már a master dián létező helyőrző alakzatokat is. A következő példa megtalálja a cím helyőrzőt és lineáris gradiens kitöltést alkalmaz rá:

import jpype
import asposeslides

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

from asposeslides.api import AutoShape, FillType, GradientShape, PlaceholderType, Presentation, SaveFormat

Color = jpype.JClass("java.awt.Color")

presentation = Presentation("presentation.pptx")
try:
    master_slide = presentation.getMasters().get_Item(0)
    title_placeholder = None

    for shape in master_slide.getShapes():
        if isinstance(shape, AutoShape):
            if shape.getPlaceholder() is not None and shape.getPlaceholder().getType() == PlaceholderType.Title:
                title_placeholder = shape
                break

    if title_placeholder is not None:
        red_gradient_color = Color(255, 0, 0)
        purple_gradient_color = Color(128, 0, 128)

        title_placeholder.getFillFormat().setFillType(FillType.Gradient)
        title_placeholder.getFillFormat().getGradientFormat().setGradientShape(GradientShape.Linear)
        title_placeholder.getFillFormat().getGradientFormat().getGradientStops().add(jpype.JFloat(0.0), red_gradient_color)
        title_placeholder.getFillFormat().getGradientFormat().getGradientStops().add(jpype.JFloat(1.0), purple_gradient_color)

    presentation.save("presentation-title-style.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Formázott cím helyőrző, amelyet a normál diák örökölnek

További helyőrző és szövegformázási lehetőségekért lásd a Set Prompt Text in Placeholder és a Text Formatting oldalakat.

Slide master háttér módosítása

A master háttér öröklődik a layoutok és a diák számára, amelyek nem írják felül. A következő példa egy egyszínű háttérszínt állít be az első master dián:

import jpype
import asposeslides

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

from asposeslides.api import BackgroundType, FillType, Presentation, SaveFormat

Color = jpype.JClass("java.awt.Color")

presentation = Presentation("presentation.pptx")
try:
    master_slide = presentation.getMasters().get_Item(0)
    master_background_color = Color.GREEN

    master_slide.getBackground().setType(BackgroundType.OwnBackground)
    master_slide.getBackground().getFillFormat().setFillType(FillType.Solid)
    master_slide.getBackground().getFillFormat().getSolidFillColor().setColor(master_background_color)

    presentation.save("presentation-master-background.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Kapcsolódó témákért lásd a Presentation Background és a Presentation Theme oldalakat.

Slide master klónozása egy másik prezentációba

A MasterSlideCollection.addClone használatával másolhat egy master diát egy másik prezentációba. A másolt master ezután a célprezentáció layoutjai és diái által használható.

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

source_presentation = Presentation("source.pptx")
destination_presentation = Presentation("destination.pptx")
try:
    source_master_slide = source_presentation.getMasters().get_Item(0)
    cloned_master_slide = destination_presentation.getMasters().addClone(source_master_slide)

    destination_presentation.save("destination-with-master.pptx", SaveFormat.Pptx)
finally:
    source_presentation.dispose()
    destination_presentation.dispose()

Ha normál diákat is a masterrel együtt szeretne klónozni, lásd a Clone Slides oldalt.

Több slide master hozzáadása

Egy prezentáció több master diát is tartalmazhat. Ez akkor hasznos, amikor a különböző szakaszok különböző márkázást, oldal struktúrát vagy téma beállításokat igényelnek.

PowerPoint parancsok master diák beszúrásához és kezeléséhez

A következő példa klónozza az alapértelmezett mastert, a klónnak más háttérszínt ad, egy layoutot hoz létre a klónozott master alatt, és egy új diát ad hozzá a layout alapján:

import jpype
import asposeslides

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

from asposeslides.api import BackgroundType, FillType, Presentation, SaveFormat, SlideLayoutType

Color = jpype.JClass("java.awt.Color")

presentation = Presentation("presentation.pptx")
try:
    default_master_slide = presentation.getMasters().get_Item(0)
    section_master_slide = presentation.getMasters().addClone(default_master_slide)
    section_master_background_color = Color.LIGHT_GRAY

    section_master_slide.getBackground().setType(BackgroundType.OwnBackground)
    section_master_slide.getBackground().getFillFormat().setFillType(FillType.Solid)
    section_master_slide.getBackground().getFillFormat().getSolidFillColor().setColor(section_master_background_color)

    source_blank_layout = default_master_slide.getLayoutSlides().getByType(SlideLayoutType.Blank)
    if source_blank_layout is None:
        source_blank_layout = default_master_slide.getLayoutSlides().get_Item(0)

    section_blank_layout = section_master_slide.getLayoutSlides().addClone(source_blank_layout)

    presentation.getSlides().addEmptySlide(section_blank_layout)
    presentation.save("presentation-with-multiple-masters.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Slide master-ek összehasonlítása

A master diák összehasonlíthatók a equals metódussal, amelyet a BaseSlide örököl. Az összehasonlítás ellenőrzi a struktúrát és a statikus tartalmat, például alakzatokat, szöveget, formázást, animációkat és egyéb dia beállításokat. Nem hasonlítja össze az egyedi azonosítókat, például a dia ID-ket, vagy a dinamikus helyőrző értékeket, például az aktuális dátumot.

import jpype
import asposeslides

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

from asposeslides.api import Presentation

first_presentation = Presentation("first.pptx")
second_presentation = Presentation("second.pptx")
try:
    first_presentation_master_count = first_presentation.getMasters().size()
    second_presentation_master_count = second_presentation.getMasters().size()

    for first_master_index in range(first_presentation_master_count):
        for second_master_index in range(second_presentation_master_count):
            first_master_slide = first_presentation.getMasters().get_Item(first_master_index)
            second_master_slide = second_presentation.getMasters().get_Item(second_master_index)
            are_master_slides_equal = first_master_slide.equals(second_master_slide)

            if are_master_slides_equal:
                print(f"first.pptx master #{first_master_index} equals second.pptx master #{second_master_index}")
finally:
    first_presentation.dispose()
    second_presentation.dispose()

További információért lásd a Compare Presentation Slides oldalt.

A slide master nézet beállítása alapértelmezett nézetnek

A setLastView metódus használatával a ViewProperties‑on szabályozhatja, hogy a PowerPoint melyik nézetet nyissa meg először. A következő példa a prezentációt Slide Master nézetben nyitja meg:

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, ViewType

presentation = Presentation("presentation.pptx")
try:
    presentation.getViewProperties().setLastView(ViewType.SlideMasterView)
    presentation.save("presentation-master-view.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

További nézetbeállításokért lásd a Save Presentation oldalt.

Felhasználatlan master diákok eltávolítása

A prezentációk néha olyan master diákat tartalmaznak, amelyeket már egyetlen normál dia sem használ. A felhasználatlan masterek eltávolítása csökkentheti a fájlméretet és egyszerűsítheti a sablon karbantartását.

A removeUnused használatával eltávolíthatja a felhasználatlan mastereket a Presentation.getMasters gyűjteményből:

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("presentation.pptx")
try:
    presentation.getMasters().removeUnused(True)
    presentation.save("presentation-clean.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Alacsony-kódú Compress.removeUnusedMasterSlides metódust is használhat:

import jpype
import asposeslides

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

from asposeslides.api import Compress, Presentation, SaveFormat

presentation = Presentation("presentation.pptx")
try:
    Compress.removeUnusedMasterSlides(presentation)
    presentation.save("presentation-clean.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

GYIK

Mi a különbség a slide master és a layout slide között?

A slide master meghatározza a közös tervezési beállításokat, például a témát, háttér, közös alakzatok és szövegstílusok. Egy layout slide a master diához tartozik és egy konkrét helyőrző elrendezést definiál. Egy normál dia egy layout slide-ot használ, így mind a layout, mind a master öröklődik.

Tartalmazhat egy prezentáció több slide master-t?

Igen. Egy prezentáció több slide master-t is tartalmazhat. Használjon több mastert, ha a különböző szakaszok különböző vizuális rendszereket vagy márkázást igényelnek.

Helyőrzőket a master diára vagy a layout diára kellene-e feltenni?

Általában a helyőrzőket a layout diákra kell feltenni. A közös vizuális elemeket és közös formázást a master diára helyezze, majd a tartalmi helyőrzőket a layoutokra, amelyeket a normál diák használni fognak.

Törölhetek olyan master diát, amely még használatban van?

Nem. Olyan master diát, amelynek vannak függő diái, nem lehet biztonságosan közvetlenül eltávolítani. Először mozdítsa át ezeket a diákat másik master alatti layoutokra, vagy használja a nem használt master-ek tisztítási módszert, amely csak a nem használt mastereket távolítja el.

Diaelrendezések alkalmazása vagy módosítása Pythonban Java-val Diaátmenetek kezelése prezentációkban Python via Java segítségével