Tillämpa eller ändra bildlayouter i Python via Java
Översikt
En bildlayout definierar positionerna och formateringen av platshållare såsom titlar, text, bilder, diagram och tabeller. Att tillämpa en layout ger bilder en konsekvent struktur samtidigt som varje bild kan innehålla sitt eget innehåll.
De vanligaste layouterna inkluderar:
- Titelbild: Innehåller platshållare för titel och undertitel.
- Titel och innehåll: Innehåller en titelplatshållare och en generisk innehållsplats.
- Tom: Innehåller inga innehållsplatshållare och är användbar när varje form placeras manuellt.
Förstå layoutarv
En presentation har tre relaterade nivåer:
- En masterbild definierar temat, delad formatering, bakgrunder och gemensamma objekt.
- En layoutbild tillhör en master och definierar en särskild placering av platshållare.
- En normal bild använder en layout och lagrar det innehåll som matats in för den bilden.
En normal bild ärver tema och formatering från sin layout, och layouten ärver från sin master. Ett värde som sätts direkt på en normal bild åsidosätter det ärvda värdet på den nivån. När en normal bild skapas genereras dess platshållarformer från den valda layouten, medan innehållet som matas in i dessa platshållare tillhör den normala bilden.
Lägg till nödvändiga platshållare i en layout innan du skapar bilder från den. Att senare lägga till en ytterligare platshållare i en layout lägger inte automatiskt till motsvarande platshållarform i befintliga normala bilder.
Detta förhållande har två viktiga följder:
- Att ändra ärvd formatering eller befintlig platshållargeometri i en layout kan uppdatera alla bilder som beror på den. Innan du redigerar en layout som redan används, inspektera dess beroende bilder och granska den resulterande presentationen.
- En layout som fortfarande används av en bild kan inte tas bort. Tilldela först dess beroende bilder till en annan layout, eller ta bara bort oanvända layouter.
För mer information om den översta nivån i detta hierarki, se Slide Master.
Välj och tillämpa en bildlayout
Använd en layouttyp när presentationen följer standarddefinitionerna för PowerPoint‑layouter. Layoutnamn kan redigeras av användaren och kan lokalanpassas, så namn‑baserad urval är mindre pålitligt om du inte kontrollerar källmallen.
Följande exempel söker efter Titel och innehåll på den första masteren. Om den layouten inte är tillgänglig faller det avsiktligt tillbaka till Tom. Den andra kontrollen för None är nödvändig eftersom en presentation kan innehålla endast anpassade layouter. Den valda layouten appliceras sedan på den första normala bilden via metoden Slide.setLayoutSlide.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, SlideLayoutType
presentation = Presentation("input.pptx")
try:
layout_slides = presentation.getMasters().get_Item(0).getLayoutSlides()
target_layout = layout_slides.getByType(SlideLayoutType.TitleAndObject)
if target_layout is None:
target_layout = layout_slides.getByType(SlideLayoutType.Blank)
if target_layout is None:
print("The first master does not contain a suitable layout slide.")
else:
presentation.getSlides().get_Item(0).setLayoutSlide(target_layout)
presentation.save("output-with-new-layout.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Att ändra en bilds layout tar inte bort vanliga former som lagts till direkt på bilden. Däremot kan platshållarpositioner, ärvd formatering och korrespondensen mellan befintliga platshållare och den nya layouten förändras, så inspektera resultatet när du byter mellan väsentligt olika layouter.
Lägg till en layoutbild
Urval och skapande är separata operationer. Det föregående exemplet väljer en befintlig layout; det skapar ingen. För att skapa en layout, anropa metoden MasterLayoutSlideCollection.add på mål‑masterens layoutsamling.
Följande exempel lägger alltid till en ny Titel och innehåll‑layout med namnet Report Title and Content, och sedan lägger till en normal bild baserad på den. Layoutnamn måste vara unika inom samlingen.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, SlideLayoutType
presentation = Presentation("input.pptx")
try:
master_slide = presentation.getMasters().get_Item(0)
report_layout = master_slide.getLayoutSlides().add(SlideLayoutType.TitleAndObject, "Report Title and Content")
presentation.getSlides().addEmptySlide(report_layout)
presentation.save("output-with-report-layout.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Lägg till en layout endast när mallen verkligen behöver en ytterligare återanvändbar struktur. Om en lämplig layout redan finns, välj och återanvänd den istället för att skapa en dubblett.
Lägg till platshållare på en layoutbild
Metoden LayoutSlide.getPlaceholderManager ger en LayoutPlaceholderManager för att lägga till platshållarformer i en layout.
Följande exempel verifierar att Tom‑layouten finns, lägger till fyra platshållare i den och skapar sedan en normal bild som använder den modifierade layouten. Ordningen är avsiktlig: platshållarna läggs till innan den normala bilden skapas, så att Aspose.Slides kan generera motsvarande platshållarformer på den bilden.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, SlideLayoutType
presentation = Presentation()
try:
blank_layout = presentation.getLayoutSlides().getByType(SlideLayoutType.Blank)
if blank_layout is None:
print("The presentation does not contain a Blank layout slide.")
else:
placeholder_manager = blank_layout.getPlaceholderManager()
placeholder_manager.addContentPlaceholder(20, 20, 310, 270)
placeholder_manager.addVerticalTextPlaceholder(350, 20, 350, 270)
placeholder_manager.addChartPlaceholder(20, 310, 310, 180)
placeholder_manager.addTablePlaceholder(350, 310, 350, 180)
presentation.getSlides().addEmptySlide(blank_layout)
presentation.save("output-with-placeholders.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Resultatet:
Warning
Att ändra ärvd formatering eller geometrin för befintliga layout‑platshållare kan påverka beroende bilder. En nylagd layout‑platshållare fylls inte på i befintliga normala bilder. Testa layout‑ändringar på en kopia av presentationen och inspektera varje beroende bild.Ta bort oanvända layoutbilder
Använd metoden Compress.removeUnusedLayoutSlides för att ta bort layouter som ingen normal bild refererar till. Metoden lämnar intakta de layouter som fortfarande används.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Compress, Presentation, SaveFormat
presentation = Presentation("input.pptx")
try:
Compress.removeUnusedLayoutSlides(presentation)
presentation.save("output-without-unused-layouts.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
För att ta bort en specifik layout, använd först dess hasDependingSlides‑ eller getDependingSlides‑metod. Tilldela om eventuella beroende bilder innan du anropar LayoutSlide.remove. Försök att ta bort en layout som används ger ett PptxEditException.
Styr fotofältets synlighet på en layoutbild
En layout har egna fotofält, bildnummer‑ och datum‑tid‑platshållare. Använd metoden LayoutSlide.getHeaderFooterManager för att kontrollera dessa platshållare för en layout. Detta är användbart när t.ex. innehålls‑layouter ska visa fotofält men titel‑layouter inte ska.
Följande exempel väljer en layout på ett säkert sätt och gör dess fotofältselement synliga:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, SlideLayoutType
presentation = Presentation("input.pptx")
try:
layout_slide = presentation.getLayoutSlides().getByType(SlideLayoutType.TitleAndObject)
if layout_slide is None:
layout_slide = presentation.getLayoutSlides().getByType(SlideLayoutType.Blank)
if layout_slide is None:
print("The presentation does not contain a suitable layout slide.")
else:
header_footer_manager = layout_slide.getHeaderFooterManager()
header_footer_manager.setFooterVisibility(True)
header_footer_manager.setSlideNumberVisibility(True)
header_footer_manager.setDateTimeVisibility(True)
header_footer_manager.setFooterText("Footer text")
header_footer_manager.setDateTimeText("Date and time text")
presentation.save("output-with-layout-footers.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Styr fotofältets synlighet på en master och dess underliggande layouter
För att tillämpa enhetliga fotofältsinställningar över en master‑hierarki, använd metoden MasterSlide.getHeaderFooterManager. Spridningsmetoderna i MasterSlideHeaderFooterManager verkar på masteren samt dess beroende layoutbilder och normala bilder; de riktar sig inte enbart mot en enskild normal bild.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("input.pptx")
try:
header_footer_manager = presentation.getMasters().get_Item(0).getHeaderFooterManager()
header_footer_manager.setFooterAndChildFootersVisibility(True)
header_footer_manager.setSlideNumberAndChildSlideNumbersVisibility(True)
header_footer_manager.setDateTimeAndChildDateTimesVisibility(True)
header_footer_manager.setFooterAndChildFootersText("Footer text")
header_footer_manager.setDateTimeAndChildDateTimesText("Date and time text")
presentation.save("output-with-master-footers.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Vanliga frågor
Vad är skillnaden mellan en masterbild och en layoutbild?
En masterbild definierar presentationens tema och delad formatering. En layoutbild tillhör en master och definierar en återanvändbar placering av platshållare. Normala bilder använder dessa layouter och lagrar bildspecifikt innehåll.
Kan jag kopiera en layoutbild från en presentation till en annan?
Ja. Lägg till en kopia i destinationssamlingen med metoden addClone. När du kopierar mellan presentationer, kontrollera även typsnitt, teman, bilder och andra resurser som används av käll‑layouten.
Vad händer när jag modifierar en layout som redan är i bruk?
Beroende bilder ärver layout‑ändringarna om de inte åsidosätter den berörda formateringen eller objekten lokalt. Platshållargeometri och ärvd stil kan därför ändras på många bilder samtidigt. Använd getDependingSlides för att identifiera de berörda bilderna innan du redigerar layouten.
Vad händer om jag tar bort en layout som fortfarande är i bruk?
Aspose.Slides kastar ett PptxEditException. Tilldela om de beroende bilderna först, eller använd removeUnusedLayoutSlides för att endast ta bort orefererade layouter.