Tillämpa eller ändra bildlayouter i Python
Ö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 enhetlig struktur samtidigt som varje bild kan innehålla sitt eget innehåll.
De vanligaste layouterna är:
- Titelbild: Innehåller platshållare för titel och undertitel.
- Titel och innehåll: Innehåller en titel‑platshållare och en allmän innehålls‑platshållare.
- Tom: Innehåller inga innehålls‑platshållare och är användbar när varje form placeras manuellt.
Förstå layoutarv
En presentation har tre relaterade nivåer:
- En master slide definierar temat, gemensam formatering, bakgrunder och vanliga objekt.
- En layout slide tillhör ett master och definierar en specifik ordning av platshållare.
- En normal slide använder en layout och lagrar innehållet som matats in för den bilden.
En normal bild ärver tema och formatering från sin layout, och layouten ärver från sitt 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 ny platshållare i en layout lägger inte automatiskt till motsvarande form i befintliga normala bilder.
Detta förhållande har två viktiga konsekvenser:
- Att ändra ärvd formatering eller befintlig platshållargeometri i en layout kan uppdatera varje bild 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 dess beroende bilder till en annan layout först, eller ta bara bort oanvända layouter.
För mer information om översta nivån i denna hierarki, se Slide Master.
För att dölja ärvda logotyper eller dekorativa master‑former på en bild eller genom en gemensam layout, se Control the Visibility of Master Graphics. Exemplet jämför två bilder som använder samma 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‑baserat urval är mindre pålitligt om du inte kontrollerar källmallen.
Följande exempel letar efter Titel och innehåll på den första master‑bilden. Om den layouten saknas faller det medvetet tillbaka till Tom. Den andra null‑kontrollen behövs eftersom en presentation kan innehålla endast anpassade layouter. Den valda layouten tillämpas sedan på den första normala bilden via egenskapen Slide.layout_slide.
import aspose.slides as slides
with slides.Presentation("input.pptx") as presentation:
layout_slides = presentation.masters[0].layout_slides
target_layout = layout_slides.get_by_type(slides.SlideLayoutType.TITLE_AND_OBJECT)
if target_layout is None:
target_layout = layout_slides.get_by_type(slides.SlideLayoutType.BLANK)
if target_layout is None:
raise RuntimeError("The first master does not contain a suitable layout slide.")
presentation.slides[0].layout_slide = target_layout
presentation.save("output-with-new-layout.pptx", slides.export.SaveFormat.PPTX)
Att ändra en bilds layout tar inte bort vanliga former som lagts till bilden direkt. Platshållarpositioner, ärvd formatering och motsvarigheten mellan befintliga platshållare och den nya layouten kan däremot 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‑masterns layoutsamling.
Följande exempel lägger alltid till en ny Titel och innehåll‑layout med namnet Report Title and Content, och lägger sedan till en normal bild baserad på den. Layoutnamn måste vara unika inom samlingen.
import aspose.slides as slides
with slides.Presentation("input.pptx") as presentation:
master_slide = presentation.masters[0]
report_layout = master_slide.layout_slides.add(slides.SlideLayoutType.TITLE_AND_OBJECT, "Report Title and Content")
presentation.slides.add_empty_slide(report_layout)
presentation.save("output-with-report-layout.pptx", slides.export.SaveFormat.PPTX)
Lägg endast till en layout 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 i en layoutbild
Egendomen LayoutSlide.placeholder_manager ger ett 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 aspose.slides as slides
with slides.Presentation() as presentation:
blank_layout = presentation.layout_slides.get_by_type(slides.SlideLayoutType.BLANK)
if blank_layout is None:
raise RuntimeError("The presentation does not contain a Blank layout slide.")
placeholder_manager = blank_layout.placeholder_manager
placeholder_manager.add_content_placeholder(20, 20, 310, 270)
placeholder_manager.add_vertical_text_placeholder(350, 20, 350, 270)
placeholder_manager.add_chart_placeholder(20, 310, 310, 180)
placeholder_manager.add_table_placeholder(350, 310, 350, 180)
presentation.slides.add_empty_slide(blank_layout)
presentation.save("output-with-placeholders.pptx", slides.export.SaveFormat.PPTX)
Resultatet:
Warning
Att ändra ärvd formatering eller geometrin för befintliga layoutplatshållare kan påverka beroende bilder. En nylagd layoutplatshållare fylls inte 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.remove_unused_layout_slides för att ta bort layouter som ingen normal bild refererar till. Metoden lämnar layouter som fortfarande används intakta.
import aspose.slides as slides
with slides.Presentation("input.pptx") as presentation:
slides.lowcode.Compress.remove_unused_layout_slides(presentation)
presentation.save("output-without-unused-layouts.pptx", slides.export.SaveFormat.PPTX)
För att ta bort en specifik layout, använd först dess egenskap has_depending_slides eller metod get_depending_slides. Tilldela eventuella beroende bilder innan du anropar LayoutSlide.remove. Ett försök att ta bort en layout som används ger en PptxEditException.
Styr sidfotens synlighet på en layoutbild
En layout har sina egna sidfot-, bild‑numrerings‑ och datum‑tid‑platshållare. Använd egenskapen LayoutSlide.header_footer_manager för att styra dessa platshållare för en layout. Detta är användbart när exempelvis innehållslayouter ska visa sidfot men titellayouter inte ska göra det.
Följande exempel väljer en layout på ett säkert sätt och gör dess sidfotelement synliga:
import aspose.slides as slides
with slides.Presentation("input.pptx") as presentation:
layout_slide = presentation.layout_slides.get_by_type(slides.SlideLayoutType.TITLE_AND_OBJECT)
if layout_slide is None:
layout_slide = presentation.layout_slides.get_by_type(slides.SlideLayoutType.BLANK)
if layout_slide is None:
raise RuntimeError("The presentation does not contain a suitable layout slide.")
header_footer_manager = layout_slide.header_footer_manager
header_footer_manager.set_footer_visibility(True)
header_footer_manager.set_slide_number_visibility(True)
header_footer_manager.set_date_time_visibility(True)
header_footer_manager.set_footer_text("Footer text")
header_footer_manager.set_date_time_text("Date and time text")
presentation.save("output-with-layout-footers.pptx", slides.export.SaveFormat.PPTX)
Styr sidfotens synlighet på ett master och dess underliggande layouter
För att tillämpa konsekventa sidfotinställningar över en master‑hierarki, använd egenskapen MasterSlide.header_footer_manager. Spridningsmetoderna i MasterSlideHeaderFooterManager verkar på master‑bilden samt dess beroende layout‑bilder och normala bilder; de riktar sig inte bara mot en enda normal bild.
import aspose.slides as slides
with slides.Presentation("input.pptx") as presentation:
header_footer_manager = presentation.masters[0].header_footer_manager
header_footer_manager.set_footer_and_child_footers_visibility(True)
header_footer_manager.set_slide_number_and_child_slide_numbers_visibility(True)
header_footer_manager.set_date_time_and_child_date_times_visibility(True)
header_footer_manager.set_footer_and_child_footers_text("Footer text")
header_footer_manager.set_date_time_and_child_date_times_text("Date and time text")
presentation.save("output-with-master-footers.pptx", slides.export.SaveFormat.PPTX)
FAQ
Vad är skillnaden mellan en master‑bild och en layout‑bild?
En master‑bild definierar presentationens tema och delad formatering. En layout‑bild tillhör ett master och definierar ett återanvändbart arrangemang av platshållare. Normala bilder använder dessa layouter och lagrar bildspecifikt innehåll.
Kan jag kopiera en layout‑bild från en presentation till en annan?
Ja. Lägg till en kopia i destinationssamlingen med metoden add_clone. När du kopierar mellan presentationer, verifiera även typsnitt, teman, bilder och andra resurser som används av käll‑layouten.
Vad händer när jag ändrar en layout som redan är i bruk?
Beroende bilder ärver layout‑ändringarna om de inte har åsidosatt den berörda formateringen eller objekten lokalt. Platshållargeometri och ärvd stil kan därmed förändras på många bilder samtidigt. Använd get_depending_slides för att identifiera de påverkade bilderna innan du redigerar layouten.
Vad händer om jag tar bort en layout som fortfarande används?
Aspose.Slides kastar en PptxEditException. Tilldela de beroende bilderna först, eller använd remove_unused_layout_slides för att bara ta bort orefererade layouter.