Gestisci i temi di presentazione in C++

Introduzione

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

In PowerPoint, un tema comprende colori, fonts, background styles, ed effetti.

theme-constituents

Modifica colore del tema

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

Questo codice C++ mostra come modificare il colore accentato per un tema:

auto pres = System::MakeObject<Presentation>();

auto shape = pres->get_Slides()->idx_get(0)->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 10.0f, 10.0f, 100.0f, 100.0f);

shape->get_FillFormat()->set_FillType(FillType::Solid);
shape->get_FillFormat()->get_SolidFillColor()->set_SchemeColor(SchemeColor::Accent4);

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

auto fillEffective = shape->get_FillFormat()->GetEffective();
    
Console::WriteLine(u"{0} ({1})", fillEffective->get_SolidFillColor().get_Name(), fillEffective->get_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 accentato (dall’operazione iniziale). Quindi cambiamo il colore nel tema:

auto otherShape = pres->get_Slides()->idx_get(0)->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 10.0f, 120.0f, 100.0f, 100.0f);
    
otherShape->get_FillFormat()->set_FillType(FillType::Solid);
otherShape->get_FillFormat()->get_SolidFillColor()->set_SchemeColor(SchemeColor::Accent4);

pres->get_MasterTheme()->get_ColorScheme()->get_Accent4()->set_Color(Color::get_Red());

Il nuovo colore viene applicato automaticamente su entrambi gli elementi.

Imposta colore del tema da una palette aggiuntiva

Quando applichi trasformazioni di luminanza al colore principale del tema(1), si formano i colori dalla palette aggiuntiva(2). Puoi quindi impostare e ottenere tali colori del tema.

additional-palette-colors

1- Colori principali del tema
2- Colori dalla palette aggiuntiva.

Questo codice C++ dimostra un’operazione in cui i colori della palette aggiuntiva vengono ottenuti dal colore principale del tema e poi utilizzati nelle forme:

auto presentation = System::MakeObject<Presentation>();

auto slide = presentation->get_Slide(0);
auto shapes = slide->get_Shapes();

// Accento 4
auto shape1 = shapes->AddAutoShape(ShapeType::Rectangle, 10.0f, 10.0f, 50.0f, 50.0f);
auto fillFormat1 = shape1->get_FillFormat();

fillFormat1->set_FillType(FillType::Solid);
fillFormat1->get_SolidFillColor()->set_SchemeColor(SchemeColor::Accent4);

// Accento 4, più chiaro 80%
auto shape2 = shapes->AddAutoShape(ShapeType::Rectangle, 10.0f, 70.0f, 50.0f, 50.0f);
auto fillFormat2 = shape2->get_FillFormat();
auto solidFillColor2 = fillFormat2->get_SolidFillColor();

fillFormat2->set_FillType(FillType::Solid);
solidFillColor2->set_SchemeColor(SchemeColor::Accent4);
solidFillColor2->get_ColorTransform()->Add(ColorTransformOperation::MultiplyLuminance, 0.2f);
solidFillColor2->get_ColorTransform()->Add(ColorTransformOperation::AddLuminance, 0.8f);

// Accento 4, più chiaro 60%
auto shape3 = shapes->AddAutoShape(ShapeType::Rectangle, 10.0f, 130.0f, 50.0f, 50.0f);
auto fillFormat3 = shape3->get_FillFormat();
auto solidFillColor3 = fillFormat3->get_SolidFillColor();

fillFormat3->set_FillType(FillType::Solid);
solidFillColor3->set_SchemeColor(SchemeColor::Accent4);
solidFillColor3->get_ColorTransform()->Add(ColorTransformOperation::MultiplyLuminance, 0.4f);
solidFillColor3->get_ColorTransform()->Add(ColorTransformOperation::AddLuminance, 0.6f);

// Accento 4, più chiaro 40%
auto shape4 = shapes->AddAutoShape(ShapeType::Rectangle, 10.0f, 190.0f, 50.0f, 50.0f);
auto fillFormat4 = shape4->get_FillFormat();
auto solidFillColor4 = fillFormat4->get_SolidFillColor();

fillFormat4->set_FillType(FillType::Solid);
solidFillColor4->set_SchemeColor(SchemeColor::Accent4);
solidFillColor4->get_ColorTransform()->Add(ColorTransformOperation::MultiplyLuminance, 0.6f);
solidFillColor4->get_ColorTransform()->Add(ColorTransformOperation::AddLuminance, 0.4f);

// Accento 4, più scuro 25%
auto shape5 = shapes->AddAutoShape(ShapeType::Rectangle, 10.0f, 250.0f, 50.0f, 50.0f);
auto fillFormat5 = shape5->get_FillFormat();
auto solidFillColor5 = fillFormat5->get_SolidFillColor();

fillFormat5->set_FillType(FillType::Solid);
solidFillColor5->set_SchemeColor(SchemeColor::Accent4);
solidFillColor5->get_ColorTransform()->Add(ColorTransformOperation::MultiplyLuminance, 0.75f);

// Accento 4, più scuro 50%
auto shape6 = shapes->AddAutoShape(ShapeType::Rectangle, 10.0f, 310.0f, 50.0f, 50.0f);
auto fillFormat6 = shape6->get_FillFormat();
auto solidFillColor6 = fillFormat6->get_SolidFillColor();

fillFormat6->set_FillType(FillType::Solid);
solidFillColor6->set_SchemeColor(SchemeColor::Accent4);
solidFillColor6->get_ColorTransform()->Add(ColorTransformOperation::MultiplyLuminance, 0.5f);

presentation->Save(u"example.pptx", Export::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::get_MasterTheme()::get_ColorScheme() restituisce IColorScheme, che espone i colori corrispondenti come:

Dark1, Dark2, Light1 e Light2.

Questa differenza è solo di denominazione. 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 carattere del tema

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

  • +mn-lt - Carattere corpo Latin (Minor Latin Font)
  • +mj-lt - Carattere intestazione Latin (Major Latin Font)
  • +mn-ea - Carattere corpo East Asian (Minor East Asian Font)
  • +mj-ea - Carattere corpo East Asian (Major East Asian Font)

Questo codice C++ mostra come assegnare il carattere Latin a un elemento del tema:

auto shape = pres->get_Slides()->idx_get(0)->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 10.0f, 10.0f, 100.0f, 100.0f);

auto paragraph = System::MakeObject<Paragraph>();
auto portion = System::MakeObject<Portion>(u"Theme text format");

paragraph->get_Portions()->Add(portion);
shape->get_TextFrame()->get_Paragraphs()->Add(paragraph);

portion->get_PortionFormat()->set_LatinFont(System::MakeObject<FontData>(u"+mn-lt"));

Questo codice C++ mostra come modificare il carattere del tema della presentazione:

pres->get_MasterTheme()->get_FontScheme()->get_Minor()->set_LatinFont(MakeObject<FontData>(u"Arial"));

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

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

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

auto pres = MakeObject<Presentation>(u"pres.pptx");
        
int32_t numberOfBackgroundFills = pres->get_MasterTheme()->get_FormatScheme()->get_BackgroundFillStyles()->get_Count();

Console::WriteLine(u"Number of background fill styles for theme is {0}", numberOfBackgroundFills);

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

pres->get_Masters()->idx_get(0)->get_Background()->set_StyleIndex(2);

Guida agli indici: 0 è usato per nessuna riempimento. L’indice inizia da 1.

Modifica effetto del tema

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

todo:image_alt_text

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

Questo codice C++ mostra come modificare un effetto del tema alterando parti degli elementi:

auto pres = System::MakeObject<Presentation>(u"Subtle_Moderate_Intense.pptx");
        
pres->get_MasterTheme()->get_FormatScheme()->get_LineStyles()->idx_get(0)->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Red());

pres->get_MasterTheme()->get_FormatScheme()->get_FillStyles()->idx_get(2)->set_FillType(FillType::Solid);

pres->get_MasterTheme()->get_FormatScheme()->get_FillStyles()->idx_get(2)->get_SolidFillColor()->set_Color(Color::get_ForestGreen());

pres->get_MasterTheme()->get_FormatScheme()->get_EffectStyles()->idx_get(2)->get_EffectFormat()->get_OuterShadowEffect()->set_Distance(10.f);

pres->Save(u"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 di tema a livello di diapositiva, quindi puoi 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?

Clone slides insieme al loro master nella presentazione di destinazione. Questo preserva il master originale, i layout e il tema associato in modo che l’aspetto rimanga coerente.

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

Utilizza le “effective” views dell’API per tema/colore/carattere/effetto. Queste restituiscono le proprietà risolte e finali dopo l’applicazione del master più eventuali sovrascritture locali.

Gestire gli sfondi della presentazione in C++