Gestire i temi di presentazione in .NET

Introduzione

Un tema di presentazione definisce le proprietà degli elementi di design. Quando scegli un tema di presentazione, stai essenzialmente selezionando un insieme specifico di elementi visivi e le loro proprietà.

In PowerPoint, un tema comprende colori, font, stili di sfondo, ed effetti.

componenti-del-tema

Modifica colore del tema

Un tema PowerPoint utilizza un insieme specifico di colori per i diversi elementi di una diapositiva. Se non ti piacciono i colori, li modifichi applicando nuovi colori al tema. Per consentirti di selezionare un nuovo colore del tema, Aspose.Slides fornisce i valori nell’enumerazione SchemeColor.

using (Presentation pres = new Presentation())
    
{
    IAutoShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 100, 100);

    shape.FillFormat.FillType = FillType.Solid;

    shape.FillFormat.SolidFillColor.SchemeColor = SchemeColor.Accent4;
}

Puoi determinare il valore efficace del colore risultante in questo modo:

var fillEffective = shape.FillFormat.GetEffective();

Console.WriteLine($"{fillEffective.SolidFillColor.Name} ({fillEffective.SolidFillColor})"); // ff8064a2 (Colore [A=255, R=128, G=100, B=162])

Per dimostrare ulteriormente l’operazione di modifica del colore, creiamo un altro elemento e gli assegniamo il colore di accento (dall’operazione iniziale). Quindi cambiamo il colore nel tema:

IAutoShape otherShape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 10, 120, 100, 100);

otherShape.FillFormat.FillType = FillType.Solid;

otherShape.FillFormat.SolidFillColor.SchemeColor = SchemeColor.Accent4;

pres.MasterTheme.ColorScheme.Accent4.Color = Color.Red;

Il nuovo colore viene applicato automaticamente a entrambi gli elementi.

Imposta colore del tema da una palette aggiuntiva

Quando applichi trasformazioni di luminanza al colore principale del tema(1), si formano colori dalla palette aggiuntiva(2). È quindi possibile impostare e recuperare quei colori del tema.

colori-palette-aggiuntiva

1 - Colori principali del tema

2 - Colori dalla palette aggiuntiva.

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

    // Accento 4
    IShape shape1 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 50, 50);

    shape1.FillFormat.FillType = FillType.Solid;
    shape1.FillFormat.SolidFillColor.SchemeColor = SchemeColor.Accent4;

    // Accento 4, più chiaro 80%
    IShape 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);

    // Accento 4, più chiaro 60%
    IShape 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);

    // Accento 4, più chiaro 40%
    IShape 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);

    // Accento 4, più scuro 25%
    IShape 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);

    // Accento 4, più scuro 50%
    IShape 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("example.pptx", SaveFormat.Pptx);
}

Mappa `SchemeColor` ai colori `IColorScheme`

Quando lavori con SchemeColor, potresti notare che contiene i seguenti valori di colore del tema:

Background1, Background2, Text1 e Text2.

Tuttavia, Presentation.MasterTheme.ColorScheme restituisce IColorScheme, che espone i colori corrispondenti come:

Dark1, Dark2, Light1 e Light2.

Questa differenza è solo nel nome. Questi valori si riferiscono alle stesse posizioni di colore del tema e la mappatura è fissa:

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

Non esiste una conversione dinamica tra Text/Background e Dark/Light. Sono semplicemente nomi alternativi per gli stessi colori del tema.

Questa differenza di denominazione proviene dalla terminologia di Microsoft Office. Le versioni precedenti di Office usavano Dark 1, Light 1, Dark 2 e Light 2, mentre le versioni UI più recenti mostrano le stesse posizioni come Text 1, Background 1, Text 2 e Background 2.

Modifica font del tema

Per consentirti di selezionare i font per i temi e altri scopi, Aspose.Slides utilizza questi identificatori speciali (simili a quelli usati in PowerPoint):

+mn-lt - Font corpo Latin (Font Latin minore)
+mj-lt - Font intestazione Latin (Font Latin principale)
+mn-ea - Font corpo East Asian (Font East Asian minore)
+mj-ea - Font corpo East Asian (Font East Asian minore)

IAutoShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 100, 100);

Paragraph paragraph = new Paragraph();

Portion portion = new Portion("Theme text format");

paragraph.Portions.Add(portion);

shape.TextFrame.Paragraphs.Add(paragraph);

portion.PortionFormat.LatinFont = new FontData("+mn-lt");

Questo codice C# mostra come assegnare il font Latin a un elemento del tema:

pres.MasterTheme.FontScheme.Minor.LatinFont = new FontData("Arial");

Il font in tutte le caselle di testo verrà aggiornato.

TIP

Potresti voler vedere font di PowerPoint.

Modifica stile di sfondo del tema

Per impostazione predefinita, l’app PowerPoint fornisce 12 sfondi predefiniti ma solo 3 di questi 12 sfondi vengono salvati in una presentazione tipica.

todo:image_alt_text

Esempio, dopo aver salvato una presentazione nell’app PowerPoint, puoi eseguire questo codice C# per scoprire il numero di sfondi predefiniti nella presentazione:

using (Presentation pres = new Presentation("pres.pptx"))

{
    int numberOfBackgroundFills = pres.MasterTheme.FormatScheme.BackgroundFillStyles.Count;

    Console.WriteLine($"Number of background fill styles for theme is {numberOfBackgroundFills}");
}

Utilizzando la proprietà BackgroundFillStyles della classe FormatScheme, è possibile aggiungere o accedere allo stile di sfondo in un tema PowerPoint.

Questo codice C# mostra come impostare lo sfondo per una presentazione:

pres.Masters[0].Background.StyleIndex = 2;

Guida all’indice: 0 viene usato per nessun riempimento. L’indice inizia da 1.

TIP

Potresti voler vedere sfondo di PowerPoint.

Modifica effetto del tema

Un tema PowerPoint solitamente contiene 3 valori per ogni array di stile. Quegli array vengono combinati in questi 3 effetti: sottile, moderato e intenso. Per esempio, questo è il risultato quando gli effetti sono applicati a una forma specifica:

todo:image_alt_text

Utilizzando 3 proprietà (FillStyles, LineStyles, EffectStyles) della classe FormatScheme è possibile modificare gli elementi in un tema (anche più flessibilmente rispetto alle opzioni in PowerPoint).

using (Presentation pres = new Presentation("Subtle_Moderate_Intense.pptx"))
{
    pres.MasterTheme.FormatScheme.LineStyles[0].FillFormat.SolidFillColor.Color = Color.Red;

    pres.MasterTheme.FormatScheme.FillStyles[2].FillType = FillType.Solid;

    pres.MasterTheme.FormatScheme.FillStyles[2].SolidFillColor.Color = Color.ForestGreen;

    pres.MasterTheme.FormatScheme.EffectStyles[2].EffectFormat.OuterShadowEffect.Distance = 10f;

    pres.Save("Design_04_Subtle_Moderate_Intense-out.pptx", SaveFormat.Pptx);
}

Le modifiche risultanti nel colore di riempimento, tipo di riempimento, effetto ombra, ecc.:

todo:image_alt_text

FAQ

Posso applicare un tema a una singola diapositiva senza modificare il master?

Sì. Aspose.Slides supporta le sovrascritture del tema a livello di diapositiva, quindi è possibile applicare un tema locale solo a quella diapositiva mantenendo intatto il tema master (tramite il SlideThemeManager).

Qual è il modo più sicuro per trasferire un tema da una presentazione all’altra?

Clona diapositive insieme al loro master nella presentazione di destinazione. Questo preserva il master originale, i layout e il tema associato affinché l’aspetto rimanga coerente.

Come posso vedere i valori “effettivi” dopo tutta l’ereditarietà e le sovrascritture?

Utilizza le “visualizzazioni effettive” dell’API [/slides/it/net/shape-effective-properties/] per tema/colore/font/effetto. Queste restituiscono le proprietà risolte e finali dopo aver applicato il master più eventuali sovrascritture locali.

Gestisci gli sfondi delle presentazioni in .NET

Gestire i temi di presentazione in .NET

Introduzione

Modifica colore del tema

Imposta colore del tema da una palette aggiuntiva

Mappa SchemeColor ai colori IColorScheme

Modifica font del tema

TIP

Modifica stile di sfondo del tema

TIP

Modifica effetto del tema

FAQ

Mappa `SchemeColor` ai colori `IColorScheme`