C++ でプレゼンテーションテーマを管理する

プレゼンテーションのテーマはデザイン要素のプロパティを定義します。プレゼンテーションテーマを選択すると、実質的に特定のビジュアル要素とそのプロパティのセットを選んでいることになります。

PowerPoint では、テーマは色、フォント、背景スタイル、および効果で構成されています。

テーマ構成要素

テーマカラーの変更

PowerPoint のテーマはスライド上のさまざまな要素に対して特定の色セットを使用します。色が気に入らない場合は、テーマに新しい色を適用して色を変更します。新しいテーマカラーを選択できるように、Aspose.Slides は SchemeColor 列挙体の値を提供します。

この C++ コードは、テーマのアクセントカラーを変更する方法を示しています：

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);

この方法で結果の色の有効値を取得できます：

auto fillEffective = shape->get_FillFormat()->GetEffective();
    
Console::WriteLine(u"{0} ({1})", fillEffective->get_SolidFillColor().get_Name(), fillEffective->get_SolidFillColor());
// ff8064a2 (カラー [A=255, R=128, G=100, B=162])

さらに色の変更操作を示すために、別の要素を作成し、最初の操作で取得したアクセントカラーを割り当てます。その後、テーマ内の色を変更します：

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());

新しい色は両方の要素に自動的に適用されます。

追加パレットからテーマカラーを設定する

メインテーマカラー(1)に対して輝度変換を適用すると、追加パレット(2)から色が生成されます。その後、これらのテーマカラーを設定および取得できます。

追加パレットの色

1- メインテーマカラー

2- 追加パレットの色

この C++ コードは、メインテーマカラーから追加パレットの色を取得し、シェイプで使用する操作を示しています：

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

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

// Accent 4
// アクセント 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);

// Accent 4, Lighter 80%
 // アクセント 4、明るく 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);

// Accent 4, Lighter 60%
 // アクセント 4、明るく 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);

// Accent 4, Lighter 40%
 // アクセント 4、明るく 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);

// Accent 4, Darker 25%
 // アクセント 4、暗く 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);

// Accent 4, Darker 50%
 // アクセント 4、暗く 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);

`SchemeColor` を `IColorScheme` の色にマッピングする

SchemeColor を使用すると、次のテーマカラー値が含まれていることに気付くかもしれません：Background1、Background2、Text1、Text2。

しかし、Presentation::get_MasterTheme()::get_ColorScheme() は IColorScheme を返し、対応する色を次のように公開します：Dark1、Dark2、Light1、Light2。

この違いは名前だけです。これらの値は同じテーマカラーのスロットを指しており、マッピングは固定されています：

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

Text/Background と Dark/Light の間に動的な変換はありません。単に同じテーマカラーの別名です。

この命名の違いは Microsoft Office の用語から来ています。古い Office バージョンは Dark 1、Light 1、Dark 2、Light 2 を使用し、最新の UI バージョンは同じスロットを Text 1、Background 1、Text 2、Background 2 と表示します。

テーマフォントの変更

テーマやその他の目的でフォントを選択できるように、Aspose.Slides は PowerPoint で使用されるものと同様の特別な識別子を使用します：

+mn-lt - 本文フォント（ラテン文字、マイナーフォント）
+mj-lt - 見出しフォント（ラテン文字、メジャーフォント）
+mn-ea - 本文フォント（東アジア文字、マイナーフォント）
+mj-ea - 本文フォント（東アジア文字、メジャーフォント）

この C++ コードは、ラテンフォントをテーマ要素に割り当てる方法を示しています：

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"));

この C++ コードは、プレゼンテーションのテーマフォントを変更する方法を示しています：

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

すべてのテキストボックスのフォントが更新されます。

TIP

PowerPoint フォントを参照すると便利です。

テーマ背景スタイルの変更

デフォルトでは、PowerPoint アプリは 12 の事前定義された背景を提供しますが、通常のプレゼンテーションに保存されるのはそのうちの 3 つだけです。

todo:image_alt_text

例えば、PowerPoint アプリでプレゼンテーションを保存した後、次の C++ コードを実行してプレゼンテーション内の事前定義背景の数を確認できます：

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);

BackgroundFillStyles プロパティを使用すると、FormatScheme クラスから PowerPoint テーマの背景スタイルを追加または取得できます。

この C++ コードは、プレゼンテーションの背景を設定する方法を示しています：

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

インデックスガイド：0 は「塗りなし」を表します。インデックスは 1 から始まります。

TIP

PowerPoint 背景を参照すると便利です。

テーマ効果の変更

PowerPoint のテーマは通常、各スタイル配列に対して 3 つの値を含みます。これらの配列は 3 つの効果（サブタル、モデレート、インテンス）に結合されます。例えば、特定のシェイプに効果を適用したときの結果は次のとおりです：

todo:image_alt_text

FormatScheme クラスの 3 つのプロパティ（FillStyles、LineStyles、EffectStyles）を使用すると、PowerPoint のオプション以上に柔軟にテーマ内の要素を変更できます。

この C++ コードは、要素の一部を変更してテーマ効果を変更する方法を示しています：

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);

結果として、塗りの色、塗りタイプ、影効果などが変更されます：

todo:image_alt_text

FAQ

スライド単位でマスターを変更せずにテーマを適用できますか？

はい。Aspose.Slides はスライドレベルのテーマオーバーライドをサポートしているため、SlideThemeManager を使用して、マスターテーマを保持したままそのスライドだけにローカルテーマを適用できます。

テーマをあるプレゼンテーションから別のプレゼンテーションへ安全に移す最善の方法は？

スライドのクローンとそのマスターを対象プレゼンテーションにコピーします。これにより元のマスター、レイアウト、関連テーマが保持され、外観が一貫します。

すべての継承とオーバーライドを適用した後の「実効」値を確認するには？

テーマ/カラー/フォント/効果の “実効” ビューを使用します。これらはマスターとローカルオーバーライドを適用した後に解決された最終プロパティを返します。

C++でプレゼンテーションの背景を管理する

C++ でプレゼンテーションテーマを管理する

テーマカラーの変更

追加パレットからテーマカラーを設定する

SchemeColor を IColorScheme の色にマッピングする

テーマフォントの変更

TIP

テーマ背景スタイルの変更

TIP

テーマ効果の変更

FAQ

`SchemeColor` を `IColorScheme` の色にマッピングする