Hantera presentationsteman i .NET

Introduktion

Ett presentationstema definierar en samordnad uppsättning färger, teckensnitt, bakgrundsstilar, fyllningar, linjer och effekter. Tema‑medvetna objekt refererar till dessa delade definitioner istället för att lagra varje visuell egenskap som ett fast värde, så att en temaförändring kan uppdatera många objekt på en gång.

I Aspose.Slides är presentationens temanivå tillgängligt via egenskapen Presentation.MasterTheme. En presentation kan också innehålla temaarv på lägre nivåer. En master kan åsidosätta presentationstemat via MasterThemeManager.OverrideTheme, en layout kan åsidosätta sitt ärvda tema via BaseOverrideThemeManager.OverrideTheme, och ett enskilt bildruta kan göra detsamma. I praktiken löses det effektiva temat för en bildruta genom denna arvskedja: presentationstema, master‑åsidosättning, layout‑åsidosättning och bildrutes‑åsidosättning.

Temakomponenter: färger, teckensnitt, bakgrundsstilar och effekter

Avsnitten nedan visar de vanligaste temaarbetsflödena: inspektera ett tema, ändra färger och teckensnitt, kopiera eller tillämpa ett tema, uppdatera bakgrunds‑ och effekstilar samt läsa effektiva värden efter att arv och åsidosättningar har lösts.

Inspektera ett tema

Objektet MasterTheme exponera temats ColorScheme, FontScheme och FormatScheme. Att inspektera dessa samlingar innan de förä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.

Följande exempel läser huvudtemats egenskaper och rapporterar hur många bakgrunds‑, fyllnings‑, linje‑ och effekstilar som lagras i temat:

using System;
using Aspose.Slides;

using var presentation = new Presentation("input.pptx");
var theme = presentation.MasterTheme;

Console.WriteLine($"Theme name: {theme.Name}");
Console.WriteLine($"Accent 1: {theme.ColorScheme.Accent1.Color}");
Console.WriteLine($"Major Latin font: {theme.FontScheme.Major.LatinFont.FontName}");
Console.WriteLine($"Minor Latin font: {theme.FontScheme.Minor.LatinFont.FontName}");
Console.WriteLine($"Background fill styles: {theme.FormatScheme.BackgroundFillStyles.Count}");
Console.WriteLine($"Fill styles: {theme.FormatScheme.FillStyles.Count}");
Console.WriteLine($"Line styles: {theme.FormatScheme.LineStyles.Count}");
Console.WriteLine($"Effect styles: {theme.FormatScheme.EffectStyles.Count}");

Om en fil använder flera masters, anta inte att varje bildruta har samma effektiva tema. Inspektera den master som är kopplad till bildrutan, och använd det effektiva temaarbetsflödet som visas senare i artikeln när layout‑ eller bildrutes‑å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 IColorScheme, 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 en temafärgsuppdatering.

Följande end‑to‑end‑exempel 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:

using System;
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 100, 100);
shape.FillFormat.FillType = FillType.Solid;
shape.FillFormat.SolidFillColor.SchemeColor = SchemeColor.Accent4;
presentation.MasterTheme.ColorScheme.Accent4.Color = Color.Red;
presentation.Save("theme-color.pptx", SaveFormat.Pptx);

using var savedPresentation = new Presentation("theme-color.pptx");
var savedSlide = savedPresentation.Slides[0];
var savedShape = savedSlide.Shapes[0];
var effectiveFill = savedShape.FillFormat.GetEffective();
Console.WriteLine($"Effective fill color: {effectiveFill.SolidFillColor}");

Eftersom rektangeln förblir länkad till Accent4 blir dess synliga färg röd efter att temat har ändrats. Om du ersätter schemafä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 applicera färgtransformeringar. Aspose.Slides exponerar dessa transformeringar via ColorTransformOperation.

Huvudtema‑färger och ljusare och mörkare färger genererade från den extra paletten

1 – Huvudtema‑färger.

2 – Ljusa och mörka varianter producerade från huvudtema‑färgerna.

Följande exempel skapar sex rektanglar baserade på Accent4, applicerar luminans‑transformeringar på fem av dem och sparar resultatet:

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape1 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 50, 50);
shape1.FillFormat.FillType = FillType.Solid;
shape1.FillFormat.SolidFillColor.SchemeColor = SchemeColor.Accent4;

var shape2 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 70, 50, 50);
shape2.FillFormat.FillType = FillType.Solid;
shape2.FillFormat.SolidFillColor.SchemeColor = SchemeColor.Accent4;
shape2.FillFormat.SolidFillColor.ColorTransform.Add(ColorTransformOperation.MultiplyLuminance, 0.2f);
shape2.FillFormat.SolidFillColor.ColorTransform.Add(ColorTransformOperation.AddLuminance, 0.8f);

var shape3 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 130, 50, 50);
shape3.FillFormat.FillType = FillType.Solid;
shape3.FillFormat.SolidFillColor.SchemeColor = SchemeColor.Accent4;
shape3.FillFormat.SolidFillColor.ColorTransform.Add(ColorTransformOperation.MultiplyLuminance, 0.4f);
shape3.FillFormat.SolidFillColor.ColorTransform.Add(ColorTransformOperation.AddLuminance, 0.6f);

var shape4 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 190, 50, 50);
shape4.FillFormat.FillType = FillType.Solid;
shape4.FillFormat.SolidFillColor.SchemeColor = SchemeColor.Accent4;
shape4.FillFormat.SolidFillColor.ColorTransform.Add(ColorTransformOperation.MultiplyLuminance, 0.6f);
shape4.FillFormat.SolidFillColor.ColorTransform.Add(ColorTransformOperation.AddLuminance, 0.4f);

var shape5 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 250, 50, 50);
shape5.FillFormat.FillType = FillType.Solid;
shape5.FillFormat.SolidFillColor.SchemeColor = SchemeColor.Accent4;
shape5.FillFormat.SolidFillColor.ColorTransform.Add(ColorTransformOperation.MultiplyLuminance, 0.75f);

var shape6 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 310, 50, 50);
shape6.FillFormat.FillType = FillType.Solid;
shape6.FillFormat.SolidFillColor.SchemeColor = SchemeColor.Accent4;
shape6.FillFormat.SolidFillColor.ColorTransform.Add(ColorTransformOperation.MultiplyLuminance, 0.5f);

presentation.Save("theme-color-palette.pptx", 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.

Mappa SchemeColor‑värden till IColorScheme‑platser

Uppräkningen SchemeColor använder Text1, Background1, Text2 och Background2, medan IColorScheme exponerar samma temaplatser som Dark1, Light1, Dark2 och Light2. Mappningen är fast:

  • Text1 = Dark1
  • Background1 = Light1
  • Text2 = Dark2
  • Background2 = Light2

Detta är alternativa namn för samma temaplatser; de är inte värden som dynamiskt konverteras från en form till en annan.

Ändra temateckensnitt

Ett temateckensnittsschema innehåller ett huvudteckensnitt för rubriker och ett mindre teckensnitt för brödtext. Egenskaperna FontScheme.Major och FontScheme.Minor exponerar dessa uppsättningar.

PowerPoint‑kompatibla temateckensnittsidenterare kan användas i textformatering:

  • +mn-lt – Brödtext Latin (Minor Latin Font)
  • +mj-lt – Rubrikfont Latin (Major Latin Font)
  • +mn-ea – Brödtext Östasiatisk (Minor East Asian Font)
  • +mj-ea – Rubrikfont Östasiatisk (Major East Asian Font)

Följande exempel skapar en rubrik som använder det stora Latin‑temateckensnittet och en brödtextlinje som använder det lilla Latin‑temateckensnittet. Det ändrar sedan temateckensnitten och sparar resultatet:

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var heading = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 40, 40, 500, 60);
heading.TextFrame.Text = "Theme heading";
heading.TextFrame.Paragraphs[0].Portions[0].PortionFormat.LatinFont = new FontData("+mj-lt");

var body = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 40, 120, 500, 60);
body.TextFrame.Text = "Theme body text";
body.TextFrame.Paragraphs[0].Portions[0].PortionFormat.LatinFont = new FontData("+mn-lt");

presentation.MasterTheme.FontScheme.Major.LatinFont = new FontData("Aptos Display");
presentation.MasterTheme.FontScheme.Minor.LatinFont = new FontData("Arial");

presentation.Save("theme-fonts.pptx", 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 en temaidentare kommer inte automatiskt att bytas när temateckensnittsschemat ändras.

De stora och små teckensnittssamlingarna kan också innehålla teckensnittsmappningar för individuella 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.

Kopiera eller tillämpa ett tema

Det finns två vanliga arbetsflöden, och de löser olika problem.

Bevara ett källtema när du flyttar bildrutor

Om du vill flytta en bildruta till en annan presentation och bevara dess ursprungliga design, klona käll‑mastern till mål‑presentationen med IMasterSlideCollection.AddClone, klona sedan bildrutan med ISlideCollection.AddClone och den klonade mastern. Detta för med sig mastern, dess layouter och det associerade temat tillsammans.

using Aspose.Slides;
using Aspose.Slides.Export;

using var source = new Presentation("source-theme.pptx");
using var target = new Presentation("target.pptx");

var sourceSlide = source.Slides[0];
var sourceMaster = sourceSlide.LayoutSlide.MasterSlide;
var clonedMaster = target.Masters.AddClone(sourceMaster);
target.Slides.AddClone(sourceSlide, clonedMaster, true);

target.Save("theme-preserved.pptx", SaveFormat.Pptx);

Detta är det föredragna arbetsflödet när käll‑bildrutan måste se likadan ut i destinationen. Att enbart klona innehåll till en orelaterad destinations‑master kan förändra temadrivna färger, teckensnitt, bakgrunder och effekter.

Tillämpa temavärden på en befintlig bildruta

Om mål‑bildrutan måste behålla sin nuvarande master och layout, initiera en bildrutes‑nivå‑åsidosättning från källtemat. Metoderna OverrideTheme.InitColorSchemeFrom, OverrideTheme.InitFontSchemeFrom och OverrideTheme.InitFormatSchemeFrom kopierar de tre huvudtema‑komponenterna till åsidosättningen.

using Aspose.Slides;
using Aspose.Slides.Export;

using var source = new Presentation("source-theme.pptx");
using var target = new Presentation("target.pptx");

var targetSlide = target.Slides[0];
var overrideTheme = targetSlide.ThemeManager.OverrideTheme;
overrideTheme.InitColorSchemeFrom(source.MasterTheme.ColorScheme);
overrideTheme.InitFontSchemeFrom(source.MasterTheme.FontScheme);
overrideTheme.InitFormatSchemeFrom(source.MasterTheme.FormatScheme);

target.Save("theme-applied-to-slide.pptx", SaveFormat.Pptx);

Detta ändrar temat som används av den bildrutan utan att ändra temat som ärvt av andra bildrutor. För att ta bort den lokala åsidosättningen och återgå till ärvda värden, anropa OverrideTheme.Clear.

Tillämpa en temåsidosättning på en layout

En layout‑nivå‑åsidosättning gäller för bildrutor som använder den layouten, såvida inte en specifik bildruta har sin egen åsidosättning. Samma initieringsmetoder kan användas via layoutens LayoutSlideThemeManager:

using Aspose.Slides;
using Aspose.Slides.Export;

using var source = new Presentation("source-theme.pptx");
using var target = new Presentation("target.pptx");

var targetLayout = target.Slides[0].LayoutSlide;
var overrideTheme = targetLayout.ThemeManager.OverrideTheme;
overrideTheme.InitColorSchemeFrom(source.MasterTheme.ColorScheme);
overrideTheme.InitFontSchemeFrom(source.MasterTheme.FontScheme);
overrideTheme.InitFormatSchemeFrom(source.MasterTheme.FormatScheme);

target.Save("theme-applied-to-layout.pptx", SaveFormat.Pptx);

Använd ett master‑ eller presentation‑nivå‑tema när många layouter och bildrutor ska dela samma grunddesign, en layout‑åsidosättning när en layout‑familj behöver annan stil, och en bildrutes‑åsidosättning endast för verkliga undantag. Överdrivna bildrutes‑åsidosättningar gör senare globala temaförändringar svårare att förutsäga.

Uppdatera temats bakgrundsstilar

Temats bakgrundsfyllningar lagras i FormatScheme.BackgroundFillStyles. PowerPoint kan presentera fler bakgrundsalternativ i sitt UI än antalet fyllningsdefinitioner som fysiskt lagras i denna samling, eftersom UI kan kombinera temafyllningar med temafärger och andra stilreferenser.

PowerPoint bakgrundsstilsgalleri för ett presentationstema

Innan du använder en bakgrundsstil, inspektera den lagrade samlingen och den aktuella Background.StyleIndex. StyleIndex använder 0 för ingen temafyllning; positiva värden är temabas‑stilreferenser. Detta skiljer sig från att indexera .NET‑samlingen direkt, där [0] betyder det första lagrade objektet. Anta inte att varje presentation innehåller samma antal bakgrundsfyllningsstilar.

Följande exempel rapporterar antalet tillgängliga bakgrundsfyllningar, tilldelar en temabaserad bakgrundsreferens till den första mastern och sparar presentationen:

using System;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("input.pptx");
var backgroundStyles = presentation.MasterTheme.FormatScheme.BackgroundFillStyles;
Console.WriteLine($"Background fill styles: {backgroundStyles.Count}");

if (backgroundStyles.Count == 0)
{
    throw new InvalidOperationException("The presentation theme does not contain background fill styles.");
}

presentation.Masters[0].Background.Type = BackgroundType.Themed;
presentation.Masters[0].Background.StyleIndex = 1;

presentation.Save("theme-background.pptx", SaveFormat.Pptx);

Det synliga resultatet beror på temaposten som refereras av mastern och på eventuella bakgrundsåsidosättningar på layout‑ eller bildrutes‑nivå. Om en bildruta använder sin egen bakgrund kan enbart ändring av masterns bakgrund eventuellt inte påverka den bildrutan. Använd Background.GetEffective när du behöver veta den slutliga bakgrunden efter att arv har tillämpats.

Uppdatera temaeffekter

Ett temautformatsschema innehåller separata samlingar för FillStyles, LineStyles, och EffectStyles. 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.

Subtila, måttliga och intensiva temaeffekter som tillämpas på samma form

När du får åtkomst till dessa samlingar i C# ä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.

Följande exempel kontrollerar att de nödvändiga stilposterna finns, ändrar den första linjestilen, ändrar den tredje fyllningsstilen, aktiverar en ytterligare skugga i den tredje effektstilen och sparar resultatet:

using System;
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("Subtle_Moderate_Intense.pptx");
var formatScheme = presentation.MasterTheme.FormatScheme;

if (formatScheme.LineStyles.Count < 1 || formatScheme.FillStyles.Count < 3 || formatScheme.EffectStyles.Count < 3)
{
    throw new InvalidOperationException("The theme does not contain the style entries required by this example.");
}

formatScheme.LineStyles[0].FillFormat.FillType = FillType.Solid;
formatScheme.LineStyles[0].FillFormat.SolidFillColor.Color = Color.Red;
formatScheme.FillStyles[2].FillType = FillType.Solid;
formatScheme.FillStyles[2].SolidFillColor.Color = Color.ForestGreen;
formatScheme.EffectStyles[2].EffectFormat.EnableOuterShadowEffect();
formatScheme.EffectStyles[2].EffectFormat.OuterShadowEffect.Distance = 10f;

presentation.Save("theme-effects.pptx", SaveFormat.Pptx);

För former som refererar till dessa platser blir den första temalinjestilen röd, den tredje temafyllningsstilen blir solid skoggrön, och den tredje effektstilen får en ytterliggande skugga med ett avstånd på 10 punkter. Det exakta visuella resultatet beror fortfarande på vilka stilplatser varje form refererar till och om direkt formatering åsidosätter temat.

Temaeffektstilar efter ändring av linje‑, fyllnings‑ och skugginställningar

Läs effektiva temavärden

Råa temobjekt visar vad som är definierat på en viss nivå. Effektiva värden visar vad en bildruta eller form faktiskt använder efter att arv och lokala åsidosättningar har lösts. För en bildruta, anropa BaseOverrideThemeManager.CreateThemeEffective. För en bakgrund, använd Background.GetEffective, och för en fyllning, använd FillFormat.GetEffective.

Följande exempel läser det effektiva temat, bakgrunden och den första formens fyllning från en bildruta:

using System;
using Aspose.Slides;

using var presentation = new Presentation("input.pptx");
var slide = presentation.Slides[0];
var effectiveTheme = slide.ThemeManager.CreateThemeEffective();
var effectiveBackground = slide.Background.GetEffective();

Console.WriteLine($"Effective major Latin font: {effectiveTheme.FontScheme.Major.LatinFont.FontName}");
Console.WriteLine($"Effective minor Latin font: {effectiveTheme.FontScheme.Minor.LatinFont.FontName}");
Console.WriteLine($"Effective background fill type: {effectiveBackground.FillFormat.FillType}");

if (slide.Shapes.Count > 0)
{
    var effectiveFill = slide.Shapes[0].FillFormat.GetEffective();
    Console.WriteLine($"First shape effective fill type: {effectiveFill.FillType}");
    if (effectiveFill.FillType == FillType.Solid)
    {
        Console.WriteLine($"First shape effective fill color: {effectiveFill.SolidFillColor}");
    }
}

Använd effektiva data för renderingsdiagnostik, validering och jämförelser. Om du endast inspekterar Presentation.MasterTheme, kan du missa en master‑, layout‑, bildrute‑ eller form‑åsidosättning som förändrar det slutliga utseendet.

FAQ

Kan jag tillämpa ett tema på en enskild bildruta utan att ändra mastern?

Ja. Använd bildrutans SlideThemeManager och initiera dess åsidosättnings‑tema. Ändringen förblir lokal för den bildrutan; andra bildrutor fortsätter att ärva sina befintliga teman.

Vad är det säkraste sättet att föra ett tema från en presentation till en annan?

När du flyttar en bildruta och bevarar dess källutseende, klona käll‑mastern till destinationen och klona bildrutan med den mastern med IMasterSlideCollection.AddClone och ISlideCollection.AddClone. Detta håller master, layouter och tema tillsammans.

Hur kan jag se de effektiva värdena efter arv och åsidosättningar?

Använd BaseOverrideThemeManager.CreateThemeEffective för en bildruta‑ eller layout‑tema och motsvarande effektiva‑datametoder för formatobjekt såsom Background.GetEffective och FillFormat.GetEffective. Dessa API:er returnerar de lösta värdena efter att arv och åsidosättningar har tillämpats.

Hantera script-specifika temafonter i .NET