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

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

PowerPoint のテーマは色、fonts、background styles、および効果で構成されます。

theme-constituents

Change Theme Color

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

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

Presentation pres = new Presentation();
try {
    IAutoShape shape = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, 100, 100);

    shape.getFillFormat().setFillType(FillType.Solid);

    shape.getFillFormat().getSolidFillColor().setSchemeColor(SchemeColor.Accent4);
} finally {
    if (pres != null) pres.dispose();
}

この方法で、結果として得られる色の実効値を確認できます:

IFillFormatEffectiveData fillEffective = shape.getFillFormat().getEffective();

Color effectiveColor = fillEffective.getSolidFillColor();

System.out.println(String.format("Color [A=%d, R=%d, G=%d, B=%d]", 
        effectiveColor.getAlpha(), effectiveColor.getRed(), effectiveColor.getGreen(), effectiveColor.getBlue()));

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

IAutoShape otherShape = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 10, 120, 100, 100);

otherShape.getFillFormat().setFillType(FillType.Solid);

otherShape.getFillFormat().getSolidFillColor().setSchemeColor(SchemeColor.Accent4);

pres.getMasterTheme().getColorScheme().getAccent4().setColor(Color.RED);

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

Set Theme Color from an Additional Palette

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

additional-palette-colors

1 - メインテーマカラー

2 - 追加パレットの色

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

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    // アクセント 4
    IShape shape1 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, 50, 50);

    shape1.getFillFormat().setFillType(FillType.Solid);
    shape1.getFillFormat().getSolidFillColor().setSchemeColor(SchemeColor.Accent4);

    // アクセント 4、明るさ 80%
    IShape shape2 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 70, 50, 50);

    shape2.getFillFormat().setFillType(FillType.Solid);
    shape2.getFillFormat().getSolidFillColor().setSchemeColor(SchemeColor.Accent4);
    shape2.getFillFormat().getSolidFillColor().getColorTransform().add(ColorTransformOperation.MultiplyLuminance, 0.2f);
    shape2.getFillFormat().getSolidFillColor().getColorTransform().add(ColorTransformOperation.AddLuminance, 0.8f);

    // アクセント 4、明るさ 60%
    IShape shape3 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 130, 50, 50);

    shape3.getFillFormat().setFillType(FillType.Solid);
    shape3.getFillFormat().getSolidFillColor().setSchemeColor(SchemeColor.Accent4);
    shape3.getFillFormat().getSolidFillColor().getColorTransform().add(ColorTransformOperation.MultiplyLuminance, 0.4f);
    shape3.getFillFormat().getSolidFillColor().getColorTransform().add(ColorTransformOperation.AddLuminance, 0.6f);

    // アクセント 4、明るさ 40%
    IShape shape4 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 190, 50, 50);

    shape4.getFillFormat().setFillType(FillType.Solid);
    shape4.getFillFormat().getSolidFillColor().setSchemeColor(SchemeColor.Accent4);
    shape4.getFillFormat().getSolidFillColor().getColorTransform().add(ColorTransformOperation.MultiplyLuminance, 0.6f);
    shape4.getFillFormat().getSolidFillColor().getColorTransform().add(ColorTransformOperation.AddLuminance, 0.4f);

    // アクセント 4、暗さ 25%
    IShape shape5 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 250, 50, 50);

    shape5.getFillFormat().setFillType(FillType.Solid);
    shape5.getFillFormat().getSolidFillColor().setSchemeColor(SchemeColor.Accent4);
    shape5.getFillFormat().getSolidFillColor().getColorTransform().add(ColorTransformOperation.MultiplyLuminance, 0.75f);

    // アクセント 4、暗さ 50%
    IShape shape6 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 310, 50, 50);

    shape6.getFillFormat().setFillType(FillType.Solid);
    shape6.getFillFormat().getSolidFillColor().setSchemeColor(SchemeColor.Accent4);
    shape6.getFillFormat().getSolidFillColor().getColorTransform().add(ColorTransformOperation.MultiplyLuminance, 0.5f);

    presentation.save(path + "example_accent4.pptx", SaveFormat.Pptx);
} finally {
    if (presentation != null) presentation.dispose();
}

Map `SchemeColor` to `IColorScheme` Colors

SchemeColor を使用する際、以下のテーマカラー値が含まれていることに気付くかもしれません:

Background1, Background2, Text1, Text2.

しかし、Presentation.getMasterTheme().getColorScheme() は 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 を使用し、 newer UI バージョンでは同じスロットが Text 1, Background 1, Text 2, Background 2 と表示されます。

Change Theme Font

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

+mn-lt - Body Font Latin (Minor Latin Font)
+mj-lt - Heading Font Latin (Major Latin Font)
+mn-ea - Body Font East Asian (Minor East Asian Font)
+mj-ea - Body Font East Asian (Major East Asian Font)

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

IAutoShape shape = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, 100, 100);

Paragraph paragraph = new Paragraph();

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

paragraph.getPortions().add(portion);

shape.getTextFrame().getParagraphs().add(paragraph);

portion.getPortionFormat().setLatinFont(new FontData("+mn-lt"));

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

pres.getMasterTheme().getFontScheme().getMinor().setLatinFont(new FontData("Arial"));

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

TIP

PowerPoint fonts を参照すると便利です。

Change Theme Background Style

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

todo:image_alt_text

たとえば、PowerPoint アプリでプレゼンテーションを保存した後、次の Java コードを実行してプレゼンテーション内の事前定義背景の数を取得できます:

Presentation pres = new Presentation("pres.pptx");
try {
    int numberOfBackgroundFills = pres.getMasterTheme().getFormatScheme().getBackgroundFillStyles().size();

    System.out.println("Number of background fill styles for theme is " + numberOfBackgroundFills);
} finally {
    if (pres != null) pres.dispose();
}

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

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

pres.getMasters().get_Item(0).getBackground().setStyleIndex(2);

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

TIP

PowerPoint Background をご覧ください。

Change Theme Effect

PowerPoint のテーマは通常、各スタイル配列に対して 3 つの値を含みます。これらの配列は 3 つの効果 (subtle, moderate, intense) に結合されます。たとえば、特定のシェイプに効果を適用した結果は次のとおりです:

todo:image_alt_text

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

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

Presentation pres = new Presentation("Subtle_Moderate_Intense.pptx");
try {
    pres.getMasterTheme().getFormatScheme().getLineStyles().get_Item(0).getFillFormat().getSolidFillColor().setColor(Color.RED);

    pres.getMasterTheme().getFormatScheme().getFillStyles().get_Item(2).setFillType(FillType.Solid);

    pres.getMasterTheme().getFormatScheme().getFillStyles().get_Item(2).getSolidFillColor().setColor(Color.GREEN);

    pres.getMasterTheme().getFormatScheme().getEffectStyles().get_Item(2).getEffectFormat().getOuterShadowEffect().setDistance(10f);

    pres.save("Design_04_Subtle_Moderate_Intense-out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

結果としての塗りの色、塗りタイプ、影効果などの変更は以下のとおりです:

todo:image_alt_text

FAQ

Can I apply a theme to a single slide without changing the master?

はい。Aspose.Slides はスライドレベルのテーマ上書きをサポートしているため、マスターテーマをそのままにして特定のスライドにローカルテーマを適用できます（SlideThemeManager を使用）。

What’s the safest way to carry a theme from one presentation to another?

Clone slides をマスターと共にターゲットプレゼンテーションにコピーします。これにより、元のマスター、レイアウト、および関連するテーマが保持され、外観が一貫します。

How can I see the “effective” values after all inheritance and overrides?

テーマ/カラー/フォント/効果の “effective” views を使用してください。これらはマスターとローカル上書きを適用した後の最終的に解決されたプロパティを返します。

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

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

Change Theme Color

Set Theme Color from an Additional Palette

Map SchemeColor to IColorScheme Colors

Change Theme Font

TIP

Change Theme Background Style

TIP

Change Theme Effect

FAQ

Map `SchemeColor` to `IColorScheme` Colors