Hantera PowerPoint-presentationsteman i Python
Introduktion
Ett presentations‑tema definierar en samordnad uppsättning färger, teckensnitt, bakgrundsstilar, fyllningar, linjer och effekter. Tema‑medvetna objekt refererar till dessa gemensamma definitioner istället för att lagra varje visuell egenskap som ett fast värde, så att ett temabyte kan uppdatera många objekt på en gång.
I Aspose.Slides är presentationsnivåns tema tillgängligt via egenskapen Presentation.master_theme. En presentation kan också innehålla temaundantag på lägre nivåer. En master kan åsidosätta presentations‑temat via MasterThemeManager.override_theme, en layout kan åsidosätta sitt ärvda tema via BaseOverrideThemeManager.override_theme, och en enskild bild kan göra detsamma. I praktiken löses det effektiva temat för en bild genom denna arvskedja: presentations‑tema, master‑åsidosättning, layout‑åsidosättning och bild‑åsidosättning.
Avsnitten nedan visar de vanligaste arbetsflödena för teman: inspektera ett tema, ändra färger och teckensnitt, kopiera eller tillämpa ett tema, uppdatera bakgrunds‑ och effektstilar samt läsa effektiva värden efter att arv och åsidosättningar har lösts.
Inspektera ett tema
Objektet MasterTheme exponerar temats egenskaper color_scheme, font_scheme och format_scheme. Att inspektera dessa samlingar innan de ändras är särskilt användbart när en presentation kommer från en extern källa, eftersom antalet och innehållet i stilposter kan variera.
Exemplet nedan läser huvudtemats egenskaper och rapporterar hur många bakgrunds‑, fyllnings‑, linje‑ och effektstilar som lagras i temat:
import aspose.slides as slides
with slides.Presentation("input.pptx") as presentation:
theme = presentation.master_theme
print(f"Theme name: {theme.name}")
print(f"Accent 1: {theme.color_scheme.accent1.color}")
print(f"Major Latin font: {theme.font_scheme.major.latin_font.font_name}")
print(f"Minor Latin font: {theme.font_scheme.minor.latin_font.font_name}")
print(f"Background fill styles: {len(theme.format_scheme.background_fill_styles)}")
print(f"Fill styles: {len(theme.format_scheme.fill_styles)}")
print(f"Line styles: {len(theme.format_scheme.line_styles)}")
print(f"Effect styles: {len(theme.format_scheme.effect_styles)}")
Om en fil använder flera masters, anta inte att varje bild har samma effektiva tema. Inspektera den master som är kopplad till bilden, och använd arbetsflödet för effektiva teman som visas senare i artikeln när layout‑ eller bild‑åsidosättningar kan finnas.
Ändra temafärger
Tema‑medvetna fyllningar, linjer och text kan referera till en logisk färg från uppräkningen SchemeColor. När du ändrar motsvarande post i temats ColorScheme, löses alla objekt som fortfarande refererar till den temafärgen mot det nya värdet. Objekt som använder en direkt RGB‑färg förändras inte av ett temafärgsuppdatering.
Exemplet nedan skapar en form som använder ACCENT4, ändrar temats accent4‑färg till röd, sparar presentationen, öppnar den igen och skriver ut den effektiva fyllningsfärgen:
import aspose.pydrawing as draw
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, 100, 100)
shape.fill_format.fill_type = slides.FillType.SOLID
shape.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
presentation.master_theme.color_scheme.accent4.color = draw.Color.red
presentation.save("theme-color.pptx", slides.export.SaveFormat.PPTX)
with slides.Presentation("theme-color.pptx") as saved_presentation:
saved_slide = saved_presentation.slides[0]
saved_shape = saved_slide.shapes[0]
effective_fill = saved_shape.fill_format.get_effective()
print(f"Effective fill color: {effective_fill.solid_fill_color}")
Eftersom rektangeln fortfarande är länkat till ACCENT4 blir dess synliga färg röd efter att temat har ändrats. Om du ersätter schema‑färgen med en direkt färg på formen, kommer senare ändringar av accent4 inte längre att påverka den fyllningen.
Använd färger från den extra paletten
PowerPoint härleder ljusare och mörkare varianter från en temafärg genom att tillämpa färgtransformeringar. Aspose.Slides exponerar dessa transformeringar via uppräkningen ColorTransformOperation.
1 – Huvudtemafärger.
2 – Ljusare och mörkare varianter som produceras från huvudtemafärgerna.
Exemplet nedan skapar sex rektanglar baserade på ACCENT4, tillämpar luminans‑transformeringar på fem av dem och sparar resultatet:
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape1 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, 50, 50)
shape1.fill_format.fill_type = slides.FillType.SOLID
shape1.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
shape2 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 70, 50, 50)
shape2.fill_format.fill_type = slides.FillType.SOLID
shape2.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
shape2.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.MULTIPLY_LUMINANCE, 0.2)
shape2.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.ADD_LUMINANCE, 0.8)
shape3 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 130, 50, 50)
shape3.fill_format.fill_type = slides.FillType.SOLID
shape3.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
shape3.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.MULTIPLY_LUMINANCE, 0.4)
shape3.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.ADD_LUMINANCE, 0.6)
shape4 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 190, 50, 50)
shape4.fill_format.fill_type = slides.FillType.SOLID
shape4.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
shape4.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.MULTIPLY_LUMINANCE, 0.6)
shape4.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.ADD_LUMINANCE, 0.4)
shape5 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 250, 50, 50)
shape5.fill_format.fill_type = slides.FillType.SOLID
shape5.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
shape5.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.MULTIPLY_LUMINANCE, 0.75)
shape6 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 310, 50, 50)
shape6.fill_format.fill_type = slides.FillType.SOLID
shape6.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
shape6.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.MULTIPLY_LUMINANCE, 0.5)
presentation.save("theme-color-palette.pptx", slides.export.SaveFormat.PPTX)
Dessa varianter förblir baserade på temafärgen. Om accent4 ändras senare räknas de transformerade färgerna om från det nya accent4‑värdet.
Koppla SchemeColor‑värden till ColorScheme‑platser
Uppräkningen SchemeColor använder TEXT1, BACKGROUND1, TEXT2 och BACKGROUND2, medan ColorScheme exponerar samma temaplatser som dark1, light1, dark2 och light2. Mappningen är fast:
TEXT1=dark1BACKGROUND1=light1TEXT2=dark2BACKGROUND2=light2
Detta är alternativa namn för samma temaplatser; de är inte värden som konverteras dynamiskt från en form till en annan.
Ändra temateckensnitt
Ett temateckensnittsschema innehåller en huvudteckensnittssamling för rubriker och en mindre teckensnittssamling för brödtext. Egenskaperna FontScheme.major och FontScheme.minor exponerar dessa samlingar.
PowerPoint‑kompatibla temateckensnittsidenterare kan användas i textformatering:
+mn-lt– Brödtext Latin (Minor Latin Font)+mj-lt– Rubrik Latin (Major Latin Font)+mn-ea– Brödtext Östasien (Minor East Asian Font)+mj-ea– Rubrik Östasien (Major East Asian Font)
Exemplet nedan skapar en rubrik som använder det stora latinska temateckensnittet och en brödtextlinje som använder det lilla latinska temateckensnittet. Därefter ändras temateckensnitten och resultatet sparas:
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
heading = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 40, 40, 500, 60)
heading.text_frame.text = "Theme heading"
heading.text_frame.paragraphs[0].portions[0].portion_format.latin_font = slides.FontData("+mj-lt")
body = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 40, 120, 500, 60)
body.text_frame.text = "Theme body text"
body.text_frame.paragraphs[0].portions[0].portion_format.latin_font = slides.FontData("+mn-lt")
presentation.master_theme.font_scheme.major.latin_font = slides.FontData("Aptos Display")
presentation.master_theme.font_scheme.minor.latin_font = slides.FontData("Arial")
presentation.save("theme-fonts.pptx", slides.export.SaveFormat.PPTX)
Rubriken följer det stora teckensnittet och brödtexten följer det lilla teckensnittet. Text som har ett explicit teckensnittsnamn istället för ett temaidentifierare kommer inte att bytas automatiskt när temateckensnittsschemat ändras.
De stora och små teckensnittssamlingarna kan också innehålla teckensnittsmappningar för enskilda skriftsystem, såsom kyrilliska, arabiska, japanska, georgiska och thaana. För att inspektera, lägga till, ersätta eller ta bort dessa mappningar, se Script‑Specific Theme Fonts.
Tips
För mer information om presentations‑teckensnitt, se PowerPoint Fonts.Kopiera eller tillämpa ett tema
Arbetsflödena nedan löser olika temarelaterade problem.
Tillämpa ett externt tema på en masters beroende bilder
Använd IMasterSlide.apply_external_theme_to_depending_slides när du har en PowerPoint‑temafil (.thmx) och vill omdesigna varje bild som är beroende av en viss master. Välj master från samlingen Presentation.masters, som implementerar MasterSlideCollection, och skicka temafilens sökväg till metoden.
Metoden utför följande steg:
- Skapar en ny master‑bild baserad på den valda mastern.
- Tillämpar det externa temat på den nya mastern.
- Tilldelar den nya mastern till alla bilder som tidigare var beroende av den valda mastern.
- Returnerar den nyskapade IMasterSlide.
Exemplet nedan tillämpar ett externt tema på de bilder som är beroende av den första mastern och sparar presentationen:
import aspose.slides as slides
with slides.Presentation("presentation.pptx") as presentation:
selected_master = presentation.masters[0]
themed_master = selected_master.apply_external_theme_to_depending_slides("corporate-theme.thmx")
print(f"Created master: {themed_master.name}")
presentation.save("presentation-with-external-theme.pptx", slides.export.SaveFormat.PPTX)
Ett ogiltigt, korrupt eller ej stödjat tema kan orsaka PptxException eller någon av dess format‑relaterade subklasser. Validera sökvägar som tillhandahålls av användare, hantera fel vid filsystemstillgång och spara presentationen först när temat har tillämpats framgångsrikt.
Endast de bilder som var beroende av den valda mastern omplaceras. Bilder som är kopplade till andra masters behåller sina befintliga masters och teman. Tema‑medvetna färger, teckensnitt, fyllningar, linjer, bakgrunder och effekter löses mot det externa temat. Direkt tilldelade färger, teckensnitt, fyllningar och annan explicit formatering kan förbli oförändrade. Åsidosättningar på layout‑ och bildnivå kan också ha företräde framför värden som ärvts från den nya mastern.
Temat kan referera till teckensnitt som inte är tillgängliga i körmiljön. För enhetlig rendering och export, installera de nödvändiga teckensnitten, tillhandahåll dem via custom font sources, eller konfigurera font substitution.
Detta är ett direkt master‑nivå‑arbetsflöde: metoden accepterar en filsökväg till en .thmx‑fil och kräver inte att man manuellt skapar tema‑åsidosättningar på bild‑ eller layoutnivå.
Tillämpa olika externa teman i en presentation med flera masters
När den relevanta mastern inte är känd i förväg, hämta den från en representativ bild via Slide.layout_slide och LayoutSlide.master_slide. Spara de ursprungliga master‑referenserna innan du tillämpar några teman eftersom varje anrop skapar en ny master i presentationen.
Exemplet nedan använder bilder från två sektioner för att lokalisera deras masters och tillämpar ett annat externt tema på varje grupp:
import aspose.slides as slides
with slides.Presentation("multi-master-presentation.pptx") as presentation:
if len(presentation.slides) < 5:
print("The presentation does not contain the expected representative slides.")
else:
first_group_master = presentation.slides[0].layout_slide.master_slide
second_group_master = presentation.slides[4].layout_slide.master_slide
if first_group_master.slide_id == second_group_master.slide_id:
print("The representative slides use the same master.")
else:
first_themed_master = first_group_master.apply_external_theme_to_depending_slides("blue-theme.thmx")
second_themed_master = second_group_master.apply_external_theme_to_depending_slides("green-theme.thmx")
print(f"First themed master: {first_themed_master.name}")
print(f"Second themed master: {second_themed_master.name}")
presentation.save("multi-master-with-external-themes.pptx", slides.export.SaveFormat.PPTX)
Det första anropet påverkar bara bilder som var beroende av first_group_master, och det andra anropet påverkar bara bilder som var beroende av second_group_master. Bilder som hör till någon annan master omdesignas inte.
Bevara ett källtema när bilder flyttas
Om du vill flytta en bild till en annan presentation och bevara dess ursprungliga design, klona käll‑mastern till mål‑presentationen med MasterSlideCollection.add_clone, klona sedan bilden med SlideCollection.add_clone och den klonade mastern. Detta för med sig mastern, dess layouter och det tillhörande temat.
import aspose.slides as slides
with slides.Presentation("source-theme.pptx") as source:
with slides.Presentation("target.pptx") as target:
source_slide = source.slides[0]
source_master = source_slide.layout_slide.master_slide
cloned_master = target.masters.add_clone(source_master)
target.slides.add_clone(source_slide, cloned_master, True)
target.save("theme-preserved.pptx", slides.export.SaveFormat.PPTX)
Detta är det föredragna arbetsflödet när käll‑bilden måste se likadan ut i destinationen. Att enbart klona innehåll till en orelaterad mål‑master kan ändra färger, teckensnitt, bakgrunder och effekter som styrs av temat.
Tillämpa temavärden på en befintlig bild
Om mål‑bilden måste förbli på sin nuvarande master och layout, initiera en bild‑nivå‑åsidosättning från källtemat. Metoderna OverrideTheme.init_color_scheme_from, OverrideTheme.init_font_scheme_from och OverrideTheme.init_format_scheme_from kopierar de tre huvudtema‑komponenterna till åsidosättningen.
import aspose.slides as slides
with slides.Presentation("source-theme.pptx") as source:
with slides.Presentation("target.pptx") as target:
target_slide = target.slides[0]
override_theme = target_slide.theme_manager.override_theme
override_theme.init_color_scheme_from(source.master_theme.color_scheme)
override_theme.init_font_scheme_from(source.master_theme.font_scheme)
override_theme.init_format_scheme_from(source.master_theme.format_scheme)
target.save("theme-applied-to-slide.pptx", slides.export.SaveFormat.PPTX)
Detta ändrar temat som används av den bilden utan att förändra temat som ärvs av andra bilder. För att ta bort den lokala åsidosättningen och återgå till ärvda värden, anropa OverrideTheme.clear.
Tillämpa en tema‑åsidosättning på en layout
En layout‑nivå‑åsidosättning gäller för bilder som använder den layouten, såvida inte en specifik bild har sin egen åsidosättning. Samma initieringsmetoder kan användas via layoutens LayoutSlideThemeManager:
import aspose.slides as slides
with slides.Presentation("source-theme.pptx") as source:
with slides.Presentation("target.pptx") as target:
target_slide = target.slides[0]
override_theme = target_slide.layout_slide.theme_manager.override_theme
override_theme.init_color_scheme_from(source.master_theme.color_scheme)
override_theme.init_font_scheme_from(source.master_theme.font_scheme)
override_theme.init_format_scheme_from(source.master_theme.format_scheme)
target.save("theme-applied-to-layout.pptx", slides.export.SaveFormat.PPTX)
Använd ett master‑ eller presentations‑tema när många layouter och bilder ska dela samma grunddesign, en layout‑åsidosättning när en layoutfamilj behöver annan formatering, och en bild‑åsidosättning bara för egentliga undantag. Överdrivna bild‑åsidosättningar gör senare globala temabyten svårare att förutse.
Uppdatera temats bakgrundsstilar
Temats bakgrundsfyllningar lagras i FormatScheme.background_fill_styles. PowerPoint kan visa fler bakgrundsalternativ i sitt UI än antalet fyllningsdefinitioner som fysiskt lagras i denna samling, eftersom UI‑t kan kombinera temafyllningar med temafärger och andra stilreferenser.
Innan du använder en bakgrundsstil, inspektera den lagrade samlingen och den aktuella Background.style_index. style_index använder 0 för ingen temafyllning; positiva värden är referenser till temats bakgrundsstil. Detta skiljer sig från indexering av en Python‑samling direkt, där [0] betyder det första lagrade elementet. Anta inte att varje presentation innehåller samma antal bakgrundsfyllningsstilar.
Exemplet nedan rapporterar antalet tillgängliga bakgrundsfyllningar, tilldelar en temareferens för bakgrund till den första mastern och sparar presentationen:
import aspose.slides as slides
with slides.Presentation("input.pptx") as presentation:
background_styles = presentation.master_theme.format_scheme.background_fill_styles
print(f"Background fill styles: {len(background_styles)}")
if len(background_styles) == 0:
raise RuntimeError("The presentation theme does not contain background fill styles.")
master_slide = presentation.masters[0]
master_slide.background.type = slides.BackgroundType.THEMED
master_slide.background.style_index = 1
presentation.save("theme-background.pptx", slides.export.SaveFormat.PPTX)
Det synliga resultatet beror på temaposten som refereras av mastern samt eventuella bakgrunds‑åsidosättningar på layout‑ eller bildnivå. Om en bild har en egen bakgrund förändras kanske inte bilden när endast master‑bakgrunden ändras. Använd Background.get_effective när du behöver veta den slutgiltiga bakgrunden efter att arv har tillämpats.
Varning
Behandla intestyle_index som ett noll‑baserat samlingsindex. Undvik också att hårdkoda ett stilnummer från en fil och anta att det har samma utseende i en annan fil; temastildefinitioner är presentations‑specifika.
Tips
För direkt bakgrundsformatering och bakgrundsarv, se Presentation Background.Uppdatera temats effekter
Ett temas format‑schema innehåller separata samlingar FormatScheme.fill_styles, FormatScheme.line_styles och FormatScheme.effect_styles. Vanliga Office‑teman innehåller ofta tre huvudsakliga stilposter som visuellt motsvarar subtil, måttlig och intensiv formatering, men kod bör inspektera varje samling istället för att anta ett fast antal.
När du får åtkomst till dessa samlingar i Python är samlingsindexet noll‑baserat: [0] är den första lagrade stilen och [2] är den tredje. En formes stil‑referensindex är ett separat koncept, exponerat via IShapeStyle. Att modifiera en temastil påverkar former som refererar till den temastilen; former med direkt formatering kan förbli oförändrade.
Exemplet nedan kontrollerar att de nödvändiga stilposterna finns, ändrar den första linjestilen, ändrar den tredje fyllningsstilen, aktiverar en yttre skugga i den tredje effektstilen och sparar resultatet:
import aspose.pydrawing as draw
import aspose.slides as slides
with slides.Presentation("Subtle_Moderate_Intense.pptx") as presentation:
format_scheme = presentation.master_theme.format_scheme
if len(format_scheme.line_styles) < 1 or len(format_scheme.fill_styles) < 3 or len(format_scheme.effect_styles) < 3:
raise RuntimeError("The theme does not contain the style entries required by this example.")
format_scheme.line_styles[0].fill_format.fill_type = slides.FillType.SOLID
format_scheme.line_styles[0].fill_format.solid_fill_color.color = draw.Color.red
format_scheme.fill_styles[2].fill_type = slides.FillType.SOLID
format_scheme.fill_styles[2].solid_fill_color.color = draw.Color.forest_green
format_scheme.effect_styles[2].effect_format.enable_outer_shadow_effect()
format_scheme.effect_styles[2].effect_format.outer_shadow_effect.distance = 10
presentation.save("theme-effects.pptx", slides.export.SaveFormat.PPTX)
För former som refererar till dessa fack blir den första temalinjestilen röd, den tredje temafyllningsstilen blir solid skoggrön, och den tredje effektstilen får en yttre skugga med ett avstånd på 10 punkter. Det exakta visuella resultatet beror fortfarande på vilka stilfack varje form refererar till och om direkt formatering åsidosätter temat.
Fastställ om en effektiv solid fyllning använder en temafärg
En fyllning kan lagras direkt på ett objekt eller ärvas från ett stycke, en layout, en master, ett temasstil eller en annan formateringsnivå. Anropa FillFormat.get_effective för att lösa hierarkin till ett oföränderligt IFillFormatEffectiveData. Kontrollera först IFillFormatEffectiveData.fill_type. Endast när den är FillType.SOLID bör du läsa solid‑fyllnings‑egenskaperna.
För en solid fyllning returnerar IFillFormatEffectiveData.solid_fill_color det slutgiltiga renderade RGB‑värdet efter arv, temauppslagning och färgtransformeringar. IFillFormatEffectiveData.solid_fill_scheme_color returnerar motsvarande logiska SchemeColor‑slot, såsom TEXT1 eller ACCENT6. Ett värde av SchemeColor.NOT_DEFINED betyder att den effektiva solida fyllningen inte baseras på en schema‑färg. I ett arbetsflöde där fyllningar antingen är temafärger eller direkta RGB‑färger, identifierar detta värde en direkt RGB‑fyllning.
Använd inte enbart det lokala värdet IColorFormat.scheme_color för att klassificera en fyllning. Till exempel kan en textdel sakna lokalt definierad schema‑färg, så dess lokala värde är NOT_DEFINED, medan dess effektiva fyllning ärvs från ett tema och blir TEXT1 eller ACCENT6. Omvänt visar solid_fill_scheme_color vilken logisk temafack som skapade den effektiva färgen, men den visar inte om den facken kom från objektet, stycket, layouten, mastern eller en annan nivå i formateringshierarkin.
Exemplet nedan laddar en presentation, granskar både form‑fyllningar och text‑del‑fyllningar, skriver ut varje slutgiltigt RGB‑värde och tillhörande schema‑färg, och markerar solida fyllningar som inte följer temafärgsändringar:
import aspose.slides as slides
def audit_fill(object_name, local_fill):
effective_fill = local_fill.get_effective()
if effective_fill.fill_type != slides.FillType.SOLID:
print(f"{object_name}: fill type = {effective_fill.fill_type}; not a solid fill.")
return
rgb = effective_fill.solid_fill_color
effective_scheme_color = effective_fill.solid_fill_scheme_color
local_scheme_color = local_fill.solid_fill_color.scheme_color
print(f"{object_name}: RGB = #{rgb.r:02X}{rgb.g:02X}{rgb.b:02X}")
print(f"{object_name}: local scheme = {local_scheme_color}, effective scheme = {effective_scheme_color}")
if effective_scheme_color == slides.SchemeColor.NOT_DEFINED:
print(f"{object_name}: direct RGB or another non-scheme fill; audit as theme-independent.")
else:
print(f"{object_name}: theme-dependent through {effective_scheme_color}.")
with slides.Presentation("input.pptx") as presentation:
for slide_index, slide in enumerate(presentation.slides):
for shape_index, shape in enumerate(slide.shapes):
shape_name = f"Slide {slide_index + 1}, shape {shape_index + 1}"
audit_fill(shape_name, shape.fill_format)
if isinstance(shape, slides.AutoShape):
for paragraph_index, paragraph in enumerate(shape.text_frame.paragraphs):
for portion_index, portion in enumerate(paragraph.portions):
portion_name = f"{shape_name}, paragraph {paragraph_index + 1}, portion {portion_index + 1}"
audit_fill(portion_name, portion.portion_format.fill_format)
Grenen NOT_DEFINED ger en granskningslista över solida fyllningar som inte svarar på förändringar i temafärgsfack. Granska dessa objekt när en presentation måste följa en ny varumärkespalett. Det rapporterade RGB‑värdet visar fortfarande det aktuella utseendet, medan schema‑värdet förklarar om det är kopplat till temat.
Effektiva‑format‑objekt är ögonblicksbilder. Efter att ha ändrat presentations‑temat, en tema‑åsidosättning eller någon ärvd formatering, anropa get_effective igen och läs ett nytt IFillFormatEffectiveData‑objekt innan du jämför eller rapporterar färger.
Läs effektiva temavärden
Råa temaobjekt visar vad som är definierat på en viss nivå. Effektiva värden visar vad en bild eller form faktiskt använder efter att arv och lokala åsidosättningar har lösts. För en bild, anropa BaseOverrideThemeManager.create_theme_effective. För en bakgrund, använd Background.get_effective, och för en fyllning, använd FillFormat.get_effective.
Exemplet nedan läser det effektiva temat, bakgrunden och den första formens fyllning från en bild:
import aspose.slides as slides
with slides.Presentation("input.pptx") as presentation:
slide = presentation.slides[0]
effective_theme = slide.theme_manager.create_theme_effective()
effective_background = slide.background.get_effective()
print(f"Effective major Latin font: {effective_theme.font_scheme.major.latin_font.font_name}")
print(f"Effective minor Latin font: {effective_theme.font_scheme.minor.latin_font.font_name}")
print(f"Effective background fill type: {effective_background.fill_format.fill_type}")
if len(slide.shapes) > 0:
effective_fill = slide.shapes[0].fill_format.get_effective()
print(f"First shape effective fill type: {effective_fill.fill_type}")
if effective_fill.fill_type == slides.FillType.SOLID:
print(f"First shape effective fill color: {effective_fill.solid_fill_color}")
Använd effektiva data för renderingsdiagnostik, validering och jämförelser. Om du bara inspekterar Presentation.master_theme, kan du missa en master‑, layout‑, bild‑ eller form‑åsidosättning som förändrar det slutgiltiga utseendet.
FAQ
Påverkar tillämpning av ett externt tema varje bild i presentationen?
Nej. IMasterSlide.apply_external_theme_to_depending_slides omfördelar bara de bilder som är beroende av den valda mastern. Bilder som använder andra masters behåller sina befintliga teman.
Kan jag tillämpa ett tema på en enskild bild utan att ändra master?
Ja. Använd bildens SlideThemeManager och initiera dess åsidosättnings‑tema. Ändringen förblir lokal för den bilden; övriga bilder fortsätter ärva sina befintliga teman.
Vad är det säkraste sättet att föra över ett tema från en presentation till en annan?
När du flyttar en bild och bevarar dess källutseende, klona käll‑mastern till destinationen och klona bilden med den mastern med MasterSlideCollection.add_clone och SlideCollection.add_clone. Detta behåller master, layouter och tema tillsammans.
Hur kan jag se de effektiva värdena efter arv och åsidosättningar?
Använd BaseOverrideThemeManager.create_theme_effective för en bild‑ eller layout‑tema och motsvarande effektiva‑data‑metoder för formatobjekt såsom Background.get_effective och FillFormat.get_effective. Dessa API‑er returnerar de lösta värdena efter att arv och åsidosättningar har tillämpats.