C++에서 프레젠테이션 테마 관리

이 페이지의 내용

Aspose.Slides for C++에서 마스터 프레젠테이션 테마를 사용하여 일관된 브랜드를 적용한 PowerPoint 파일을 만들고, 맞춤화하고, 변환합니다.

소개

프레젠테이션 테마는 색상, 글꼴, 배경 스타일, 채우기, 선, 효과 등으로 구성된 조정된 세트를 정의합니다. 테마 인식 객체는 이러한 공유 정의를 참조하고 각 시각 속성을 고정값으로 저장하지 않으므로 테마를 변경하면 여러 객체를 한 번에 업데이트할 수 있습니다.

Aspose.Slides에서 프레젠테이션 수준 테마는 Presentation::get_MasterTheme()를 통해 사용할 수 있습니다. 프레젠테이션은 하위 수준에서도 테마 재정의를 포함할 수 있습니다. 마스터는 MasterThemeManager::get_OverrideTheme()를 통해 프레젠테이션 테마를 재정의할 수 있고, 레이아웃이나 개별 슬라이드는 IOverrideThemeManager::get_OverrideTheme()를 사용할 수 있습니다. 실제로 슬라이드에 적용되는 테마는 다음과 같은 상속 체인을 통해 결정됩니다: 프레젠테이션 테마 → 마스터 재정의 → 레이아웃 재정의 → 슬라이드 재정의.

Theme components: colors, fonts, background styles, and effects

아래 섹션에서는 가장 일반적인 테마 작업 흐름을 보여 줍니다: 테마 검사, 색상 및 글꼴 변경, 테마 복사 또는 적용, 배경 및 효과 스타일 업데이트, 그리고 상속 및 재정의가 해결된 후의 유효값 읽기.

테마 검사

MasterTheme 객체는 테마의 get_ColorScheme(), get_FontScheme(), get_FormatScheme() 메서드를 노출합니다. 변경하기 전에 이러한 컬렉션을 검사하면 프레젠테이션이 외부 소스에서 온 경우 스타일 항목의 수와 내용이 달라질 수 있기 때문에 특히 유용합니다.

다음 예제는 기본 테마 속성을 읽고 배경, 채우기, 선, 효과 스타일이 각각 몇 개 저장되어 있는지 보고합니다:

#include <DOM/IColorFormat.h>
#include <DOM/IFonts.h>
#include <DOM/Presentation.h>
#include <DOM/Theme/IColorScheme.h>
#include <DOM/Theme/IEffectStyleCollection.h>
#include <DOM/Theme/IFillFormatCollection.h>
#include <DOM/Theme/IFontScheme.h>
#include <DOM/Theme/IFormatScheme.h>
#include <DOM/Theme/ILineFormatCollection.h>
#include <DOM/Theme/IMasterTheme.h>
#include <system/console.h>

using namespace Aspose::Slides;
using namespace System;

auto presentation = MakeObject<Presentation>(u"input.pptx");
auto theme = presentation->get_MasterTheme();
auto formatScheme = theme->get_FormatScheme();

Console::WriteLine(u"Theme name: {0}", theme->get_Name());
Console::WriteLine(u"Accent 1: {0}", theme->get_ColorScheme()->get_Accent1()->get_Color());
Console::WriteLine(u"Major Latin font: {0}", theme->get_FontScheme()->get_Major()->get_LatinFont()->get_FontName());
Console::WriteLine(u"Minor Latin font: {0}", theme->get_FontScheme()->get_Minor()->get_LatinFont()->get_FontName());
Console::WriteLine(u"Background fill styles: {0}", formatScheme->get_BackgroundFillStyles()->get_Count());
Console::WriteLine(u"Fill styles: {0}", formatScheme->get_FillStyles()->get_Count());
Console::WriteLine(u"Line styles: {0}", formatScheme->get_LineStyles()->get_Count());
Console::WriteLine(u"Effect styles: {0}", formatScheme->get_EffectStyles()->get_Count());

파일에 여러 마스터가 사용된 경우 모든 슬라이드가 동일한 유효 테마를 갖는다고 가정하지 마세요. 슬라이드와 연결된 마스터를 검사하고, 레이아웃이나 슬라이드 재정의가 존재할 수 있는 경우 아래에 제시된 유효‑테마 작업 흐름을 사용하세요.

테마 색상 변경

테마 인식 채우기, 선, 텍스트는 SchemeColor 열거형에 정의된 논리 색상을 참조할 수 있습니다. 테마의 IColorScheme에서 해당 항목을 변경하면 해당 테마 색상을 여전히 참조하는 모든 객체가 새로운 값으로 해결됩니다. 직접 RGB 색상을 사용하는 객체는 테마 색상 업데이트의 영향을 받지 않습니다.

다음 엔드‑투‑엔드 예제는 Accent4를 사용하는 도형을 만든 뒤, 테마의 Accent4 색상을 빨간색으로 변경하고, 프레젠테이션을 저장한 뒤 다시 열어 유효 채우기 색상을 출력합니다:

#include <DOM/FillType.h>
#include <DOM/IAutoShape.h>
#include <DOM/IColorFormat.h>
#include <DOM/IFillFormat.h>
#include <DOM/IFillFormatEffectiveData.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/Presentation.h>
#include <DOM/SchemeColor.h>
#include <DOM/ShapeType.h>
#include <DOM/Theme/IColorScheme.h>
#include <DOM/Theme/IMasterTheme.h>
#include <Export/SaveFormat.h>
#include <drawing/color.h>
#include <system/console.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;
using namespace System::Drawing;

auto presentation = MakeObject<Presentation>();
auto slide = presentation->get_Slide(0);
auto shape = slide->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);
presentation->get_MasterTheme()->get_ColorScheme()->get_Accent4()->set_Color(Color::get_Red());
presentation->Save(u"theme-color.pptx", SaveFormat::Pptx);

auto savedPresentation = MakeObject<Presentation>(u"theme-color.pptx");
auto savedSlide = savedPresentation->get_Slide(0);
auto savedShape = savedSlide->get_Shape(0);
auto effectiveFill = savedShape->get_FillFormat()->GetEffective();
Console::WriteLine(u"Effective fill color: {0}", effectiveFill->get_SolidFillColor());

사각형이 Accent4에 계속 연결되어 있기 때문에 테마가 변경되면 표시 색상이 빨간색으로 바뀝니다. 도형에 직접 색상을 지정하면 이후 Accent4가 변경되더라도 해당 채우기에는 영향을 주지 않게 됩니다.

추가 팔레트의 색상 사용

PowerPoint는 테마 색상에 색상 변환을 적용하여 더 밝거나 어두운 변형을 생성합니다. Aspose.Slides는 이러한 변환을 ColorTransformOperation을 통해 노출합니다.

Main theme colors and lighter and darker colors generated from the additional palette

1 – 기본 테마 색상.

2 – 기본 테마 색상에서 생성된 밝고 어두운 변형.

다음 예제는 Accent4를 기반으로 여섯 개 사각형을 만들고, 그 중 다섯 개에 밝기 변환을 적용한 뒤 결과를 저장합니다:

#include <DOM/ColorTransformOperation.h>
#include <DOM/FillType.h>
#include <DOM/IAutoShape.h>
#include <DOM/IColorFormat.h>
#include <DOM/IColorOperationCollection.h>
#include <DOM/IFillFormat.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/Presentation.h>
#include <DOM/SchemeColor.h>
#include <DOM/ShapeType.h>
#include <Export/SaveFormat.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;

auto presentation = MakeObject<Presentation>();
auto shapes = presentation->get_Slide(0)->get_Shapes();

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

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

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

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

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

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"theme-color-palette.pptx", SaveFormat::Pptx);

이 변형들은 테마 색상을 기반으로 유지됩니다. Accent4가 이후에 변경되면 변환된 색상도 새로운 Accent4 값으로 재계산됩니다.

`SchemeColor` 값을 `IColorScheme` 슬롯에 매핑

SchemeColor 열거형은 Text1, Background1, Text2, Background2를 사용하고, IColorScheme은 동일한 테마 슬롯을 Dark1, Light1, Dark2, Light2로 노출합니다. 매핑은 고정됩니다:

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

이는 같은 테마 슬롯에 대한 별칭이며, 한 형태에서 다른 형태로 동적으로 변환되는 값이 아닙니다.

테마 글꼴 변경

테마 글꼴 스킴은 제목용 주요 글꼴 집합과 본문용 보조 글꼴 집합을 포함합니다. FontScheme::get_Major()와 FontScheme::get_Minor() 메서드가 해당 집합을 노출합니다.

PowerPoint와 호환되는 테마 글꼴 식별자는 텍스트 서식에 사용할 수 있습니다:

+mn-lt – 본문 라틴 글꼴 (Minor Latin Font)
+mj-lt – 제목 라틴 글꼴 (Major Latin Font)
+mn-ea – 본문 동아시아 글꼴 (Minor East Asian Font)
+mj-ea – 제목 동아시아 글꼴 (Major East Asian Font)

다음 예제는 주요 라틴 테마 글꼴을 사용하는 제목 하나와 보조 라틴 테마 글꼴을 사용하는 본문 한 줄을 만든 뒤, 테마 글꼴을 변경하고 결과를 저장합니다:

#include <DOM/Fonts/FontData.h>
#include <DOM/IAutoShape.h>
#include <DOM/IFonts.h>
#include <DOM/IParagraph.h>
#include <DOM/IParagraphCollection.h>
#include <DOM/IPortion.h>
#include <DOM/IPortionCollection.h>
#include <DOM/IPortionFormat.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/ITextFrame.h>
#include <DOM/Presentation.h>
#include <DOM/ShapeType.h>
#include <DOM/Theme/IFontScheme.h>
#include <DOM/Theme/IMasterTheme.h>
#include <Export/SaveFormat.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;

auto presentation = MakeObject<Presentation>();
auto slide = presentation->get_Slide(0);

auto heading = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 40.0f, 40.0f, 500.0f, 60.0f);
heading->get_TextFrame()->set_Text(u"Theme heading");
heading->get_TextFrame()->get_Paragraph(0)->get_Portion(0)->get_PortionFormat()->set_LatinFont(MakeObject<FontData>(u"+mj-lt"));

auto body = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 40.0f, 120.0f, 500.0f, 60.0f);
body->get_TextFrame()->set_Text(u"Theme body text");
body->get_TextFrame()->get_Paragraph(0)->get_Portion(0)->get_PortionFormat()->set_LatinFont(MakeObject<FontData>(u"+mn-lt"));

presentation->get_MasterTheme()->get_FontScheme()->get_Major()->set_LatinFont(MakeObject<FontData>(u"Aptos Display"));
presentation->get_MasterTheme()->get_FontScheme()->get_Minor()->set_LatinFont(MakeObject<FontData>(u"Arial"));
presentation->Save(u"theme-fonts.pptx", SaveFormat::Pptx);

제목은 주요 글꼴을 따르고 본문 텍스트는 보조 글꼴을 따릅니다. 명시적으로 글꼴 이름을 지정한 텍스트는 테마 글꼴 스킴이 변경되어도 자동으로 전환되지 않습니다.

주요·보조 글꼴 컬렉션에는 키릴 문자, 아랍어, 일본어, 그루지아어, 타나어와 같은 개별 문자 체계에 대한 매핑도 포함될 수 있습니다. 이러한 매핑을 검사·추가·교체·제거하려면 Script‑Specific Theme Fonts를 참고하세요.

팁

프레젠테이션 글꼴에 대한 자세한 내용은 PowerPoint Fonts를 보세요.

테마 복사 또는 적용

아래 작업 흐름은 각각 다른 테마 관련 문제를 해결합니다.

외부 테마를 마스터에 종속된 슬라이드에 적용

PowerPoint 테마 파일(.thmx)이 있고 해당 마스터에 종속된 모든 슬라이드의 스타일을 바꾸고 싶을 때는 IMasterSlide::ApplyExternalThemeToDependingSlides를 사용합니다. Presentation::get_Masters 컬렉션에서 마스터를 선택하고(이 컬렉션은 IMasterSlideCollection을 구현함), 테마 파일 경로를 메서드에 전달합니다.

메서드는 다음 작업을 수행합니다:

선택한 마스터를 기반으로 새 마스터 슬라이드를 생성합니다.
외부 테마를 새 마스터에 적용합니다.
이전에 선택한 마스터에 종속되었던 모든 슬라이드에 새 마스터를 할당합니다.
새로 만든 IMasterSlide를 반환합니다.

다음 예제는 첫 번째 마스터에 종속된 슬라이드에 외부 테마를 적용하고 프레젠테이션을 저장합니다:

#include <DOM/IMasterSlide.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>
#include <iostream>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;

auto presentation = MakeObject<Presentation>(u"presentation.pptx");
auto selectedMaster = presentation->get_Master(0);
auto themedMaster = selectedMaster->ApplyExternalThemeToDependingSlides(u"corporate-theme.thmx");

Console::WriteLine(u"Created master: {0}", themedMaster->get_Name());
presentation->Save(u"presentation-with-external-theme.pptx", SaveFormat::Pptx);

잘못되었거나 손상되었거나 지원되지 않는 테마는 PptxException 또는 그 하위 형식을 발생시킬 수 있습니다. 사용자가 제공한 경로를 검증하고 파일 시스템 접근 오류를 처리한 뒤, 테마 적용이 성공적으로 끝난 후에만 프레젠테이션을 저장하세요.

선택한 마스터에 종속된 슬라이드만 재할당됩니다. 다른 마스터에 연결된 슬라이드는 기존 마스터와 테마를 유지합니다. 테마 인식 색상, 글꼴, 채우기, 선, 배경, 효과는 외부 테마에 맞춰 해결됩니다. 직접 지정된 색상·글꼴·채우기 등 명시적 서식은 변경되지 않을 수 있습니다. 레이아웃 수준·슬라이드 수준 재정의도 새 마스터에서 상속된 값보다 우선할 수 있습니다.

테마가 런타임 환경에 없는 글꼴을 참조할 수 있습니다. 일관된 렌더링 및 내보내기를 위해 필요한 글꼴을 설치하거나 custom font sources를 통해 제공하거나 font substitution을 구성하세요.

이 작업 흐름은 마스터 수준 직접 작업이며, .thmx 파일 경로만 전달하고 슬라이드‑레벨·레이아웃‑레벨 테마 재정의를 별도로 만들 필요가 없습니다.

다중 마스터 프레젠테이션에서 서로 다른 외부 테마 적용

사전에 어떤 마스터가 사용될지 모르는 경우, ISlide::get_LayoutSlide와 ILayoutSlide::get_MasterSlide를 통해 대표 슬라이드에서 마스터를 얻어야 합니다. 테마를 적용하기 전에 원본 마스터 참조를 저장해 두세요. 각 호출이 프레젠테이션에 새 마스터를 생성하기 때문입니다.

다음 예제는 두 섹션의 슬라이드를 사용해 각각의 마스터를 찾고, 각 그룹에 서로 다른 외부 테마를 적용합니다:

#include <DOM/ILayoutSlide.h>
#include <DOM/IMasterSlide.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>
#include <iostream>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;

auto presentation = MakeObject<Presentation>(u"multi-master-presentation.pptx");

if (presentation->get_Slides()->get_Count() < 5)
{
    std::cout << "The presentation does not contain the expected representative slides." << std::endl;
}
else
{
    auto firstGroupMaster = presentation->get_Slide(0)->get_LayoutSlide()->get_MasterSlide();
    auto secondGroupMaster = presentation->get_Slide(4)->get_LayoutSlide()->get_MasterSlide();

    if (firstGroupMaster->get_SlideId() == secondGroupMaster->get_SlideId())
    {
        std::cout << "The representative slides use the same master." << std::endl;
    }
    else
    {
        auto firstThemedMaster = firstGroupMaster->ApplyExternalThemeToDependingSlides(u"blue-theme.thmx");
        auto secondThemedMaster = secondGroupMaster->ApplyExternalThemeToDependingSlides(u"green-theme.thmx");

        Console::WriteLine(u"First themed master: {0}", firstThemedMaster->get_Name());
        Console::WriteLine(u"Second themed master: {0}", secondThemedMaster->get_Name());
        presentation->Save(u"multi-master-with-external-themes.pptx", SaveFormat::Pptx);
    }
}

첫 번째 호출은 firstGroupMaster에 종속된 슬라이드에만 영향을 주고, 두 번째 호출은 secondGroupMaster에 종속된 슬라이드에만 영향을 줍니다. 다른 마스터에 속한 슬라이드는 재스타일링되지 않습니다.

슬라이드 이동 시 원본 테마 보존

슬라이드를 다른 프레젠테이션으로 이동하면서 원본 디자인을 유지하려면 IMasterSlideCollection::AddClone()으로 원본 마스터를 대상 프레젠테이션에 복제한 뒤, ISlideCollection::AddClone()와 복제된 마스터를 사용해 슬라이드를 복제합니다. 이렇게 하면 마스터와 레이아웃, 연결된 테마가 함께 이동됩니다.

#include <DOM/ILayoutSlide.h>
#include <DOM/IMasterSlide.h>
#include <DOM/IMasterSlideCollection.h>
#include <DOM/ISlide.h>
#include <DOM/ISlideCollection.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;

auto source = MakeObject<Presentation>(u"source-theme.pptx");
auto target = MakeObject<Presentation>(u"target.pptx");
auto sourceSlide = source->get_Slide(0);
auto sourceMaster = sourceSlide->get_LayoutSlide()->get_MasterSlide();
auto clonedMaster = target->get_Masters()->AddClone(sourceMaster);
target->get_Slides()->AddClone(sourceSlide, clonedMaster, true);
target->Save(u"theme-preserved.pptx", SaveFormat::Pptx);

대상 프레젠테이션에서 동일한 외관을 유지해야 할 때 권장되는 작업 흐름입니다. 내용만 복제하고 관계없는 대상 마스터에 붙이면 테마 기반 색상·글꼴·배경·효과가 변경될 수 있습니다.

기존 슬라이드에 테마 값 적용

대상 슬라이드가 현재 마스터와 레이아웃을 유지해야 하는 경우, 원본 테마를 사용해 슬라이드‑레벨 재정의를 초기화합니다. OverrideTheme::InitColorSchemeFrom(), OverrideTheme::InitFontSchemeFrom(), OverrideTheme::InitFormatSchemeFrom() 메서드가 세 가지 주요 테마 요소를 재정의에 복사합니다.

#include <DOM/ISlide.h>
#include <DOM/Presentation.h>
#include <DOM/Theme/IOverrideTheme.h>
#include <DOM/Theme/IOverrideThemeManager.h>
#include <DOM/Theme/IMasterTheme.h>
#include <Export/SaveFormat.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;

auto source = MakeObject<Presentation>(u"source-theme.pptx");
auto target = MakeObject<Presentation>(u"target.pptx");
auto targetSlide = target->get_Slide(0);
auto overrideTheme = targetSlide->get_ThemeManager()->get_OverrideTheme();
overrideTheme->InitColorSchemeFrom(source->get_MasterTheme()->get_ColorScheme());
overrideTheme->InitFontSchemeFrom(source->get_MasterTheme()->get_FontScheme());
overrideTheme->InitFormatSchemeFrom(source->get_MasterTheme()->get_FormatScheme());
target->Save(u"theme-applied-to-slide.pptx", SaveFormat::Pptx);

이렇게 하면 해당 슬라이드에만 테마가 변경되고, 다른 슬라이드가 상속받는 테마는 그대로 유지됩니다. 로컬 재정의를 제거하고 상속값으로 돌아가려면 OverrideTheme::Clear()를 호출하세요.

레이아웃에 테마 재정의 적용

레이아웃‑레벨 재정의는 해당 레이아웃을 사용하는 모든 슬라이드에 적용되며, 개별 슬라이드가 자체 재정의를 가지고 있지 않은 경우에만 적용됩니다. 동일한 초기화 메서드를 레이아웃의 IOverrideThemeManager를 통해 사용할 수 있습니다:

#include <DOM/ILayoutSlide.h>
#include <DOM/ISlide.h>
#include <DOM/Presentation.h>
#include <DOM/Theme/IOverrideTheme.h>
#include <DOM/Theme/IOverrideThemeManager.h>
#include <DOM/Theme/IMasterTheme.h>
#include <Export/SaveFormat.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;

auto source = MakeObject<Presentation>(u"source-theme.pptx");
auto target = MakeObject<Presentation>(u"target.pptx");
auto targetSlide = target->get_Slide(0);
auto targetLayout = targetSlide->get_LayoutSlide();
auto overrideTheme = targetLayout->get_ThemeManager()->get_OverrideTheme();
overrideTheme->InitColorSchemeFrom(source->get_MasterTheme()->get_ColorScheme());
overrideTheme->InitFontSchemeFrom(source->get_MasterTheme()->get_FontScheme());
overrideTheme->InitFormatSchemeFrom(source->get_MasterTheme()->get_FormatScheme());
target->Save(u"theme-applied-to-layout.pptx", SaveFormat::Pptx);

많은 레이아웃·슬라이드가 동일한 기본 디자인을 공유해야 하면 마스터·프레젠테이션 수준 테마를 사용하고, 하나의 레이아웃군에 다른 스타일이 필요하면 레이아웃 재정의를, 실제 예외에 대해서만 슬라이드 재정의를 적용합니다. 슬라이드‑레벨 재정의를 과도하게 사용하면 이후 전역 테마 변경을 예측하기 어려워집니다.

테마 배경 스타일 업데이트

테마의 배경 채우기는 FormatScheme::get_BackgroundFillStyles()에 저장됩니다. PowerPoint UI에서는 실제 컬렉션에 저장된 채우기 정의 수보다 더 많은 배경 옵션을 제공할 수 있는데, 이는 UI가 테마 채우기와 테마 색상·기타 스타일 참조를 조합하기 때문입니다.

PowerPoint background style gallery for a presentation theme

배경 스타일을 사용하기 전에 저장된 컬렉션과 현재 Background::get_StyleIndex()를 확인하세요. StyleIndex가 0이면 테마 채우기가 없으며, 양수값은 테마 배경‑스타일 참조를 의미합니다. 이는 C++ 컬렉션을 idx_get(0)으로 직접 인덱싱할 때 0이 첫 번째 항목을 의미하는 것과 다릅니다. 모든 프레젠테이션이 동일한 수의 배경 채우기 스타일을 갖는다고 가정하지 마세요.

다음 예제는 사용 가능한 배경 채우기 개수를 보고하고, 첫 번째 마스터에 테마 배경 참조를 할당한 뒤 프레젠테이션을 저장합니다:

#include <DOM/BackgroundType.h>
#include <DOM/IBackground.h>
#include <DOM/IMasterSlide.h>
#include <DOM/Presentation.h>
#include <DOM/Theme/IFillFormatCollection.h>
#include <DOM/Theme/IFormatScheme.h>
#include <DOM/Theme/IMasterTheme.h>
#include <Export/SaveFormat.h>
#include <system/console.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;

auto presentation = MakeObject<Presentation>(u"input.pptx");
auto backgroundStyles = presentation->get_MasterTheme()->get_FormatScheme()->get_BackgroundFillStyles();
Console::WriteLine(u"Background fill styles: {0}", backgroundStyles->get_Count());

if (backgroundStyles->get_Count() > 0)
{
    auto masterSlide = presentation->get_Master(0);
    masterSlide->get_Background()->set_Type(BackgroundType::Themed);
    masterSlide->get_Background()->set_StyleIndex(1);
    presentation->Save(u"theme-background.pptx", SaveFormat::Pptx);
}

보이는 결과는 마스터가 참조하는 테마 항목과 레이아웃·슬라이드 수준에서 적용된 배경 재정의에 따라 달라집니다. 슬라이드가 자체 배경을 사용하고 있다면 마스터 배경만 변경해도 해당 슬라이드에는 영향을 주지 않을 수 있습니다. 최종 배경을 알아야 하면 Background::GetEffective()를 사용하세요.

경고

StyleIndex를 0 기반 컬렉션 인덱스로 취급하지 마세요. 또한 하나의 파일에서 스타일 번호를 하드코딩하고 다른 파일에서도 동일한 외형을 기대하지 마세요. 테마 스타일 정의는 프레젠테이션마다 다릅니다.

팁

직접 배경 서식 및 배경 상속에 대해서는 Presentation Background을 참고하세요.

테마 효과 업데이트

테마 포맷 스킴은 별개의 FormatScheme::get_FillStyles(), FormatScheme::get_LineStyles(), FormatScheme::get_EffectStyles() 컬렉션을 포함합니다. 일반적인 Office 테마는 미묘, 보통, 강렬한 서식을 시각적으로 매칭하는 세 개의 주요 스타일 항목을 포함하지만, 코드는 고정된 개수를 가정하지 말고 각 컬렉션을 검사해야 합니다.

Subtle, moderate, and intense theme effects applied to the same shape

C++에서 이러한 컬렉션에 접근할 때 인덱스는 0 기반입니다: idx_get(0)은 첫 번째 저장된 스타일이며 idx_get(2)는 세 번째 스타일입니다. 도형의 스타일‑참조 인덱스는 별개의 개념으로, IShapeStyle을 통해 노출됩니다. 테마 스타일을 수정하면 해당 테마 스타일을 참조하는 도형에 영향을 주며, 직접 서식된 도형은 변경되지 않을 수 있습니다.

다음 예제는 필요한 스타일 항목이 존재하는지 확인하고, 첫 번째 선 스타일을 변경하고, 세 번째 채우기 스타일을 변경하고, 세 번째 효과 스타일에 외부 그림자를 활성화한 뒤 결과를 저장합니다:

#include <DOM/Effects/IOuterShadow.h>
#include <DOM/FillType.h>
#include <DOM/IColorFormat.h>
#include <DOM/IEffectFormat.h>
#include <DOM/IFillFormat.h>
#include <DOM/ILineFormat.h>
#include <DOM/Presentation.h>
#include <DOM/Theme/IEffectStyle.h>
#include <DOM/Theme/IEffectStyleCollection.h>
#include <DOM/Theme/IFillFormatCollection.h>
#include <DOM/Theme/IFormatScheme.h>
#include <DOM/Theme/ILineFormatCollection.h>
#include <DOM/Theme/IMasterTheme.h>
#include <Export/SaveFormat.h>
#include <drawing/color.h>
#include <system/console.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;
using namespace System::Drawing;

auto presentation = MakeObject<Presentation>(u"Subtle_Moderate_Intense.pptx");
auto formatScheme = presentation->get_MasterTheme()->get_FormatScheme();
auto lineStyles = formatScheme->get_LineStyles();
auto fillStyles = formatScheme->get_FillStyles();
auto effectStyles = formatScheme->get_EffectStyles();

if (lineStyles->get_Count() < 1 || fillStyles->get_Count() < 3 || effectStyles->get_Count() < 3)
{
    Console::WriteLine(u"The theme does not contain the style entries required by this example.");
}
else
{
    auto lineStyle = lineStyles->idx_get(0);
    lineStyle->get_FillFormat()->set_FillType(FillType::Solid);
    lineStyle->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Red());

    auto fillStyle = fillStyles->idx_get(2);
    fillStyle->set_FillType(FillType::Solid);
    fillStyle->get_SolidFillColor()->set_Color(Color::get_ForestGreen());

    auto effectFormat = effectStyles->idx_get(2)->get_EffectFormat();
    effectFormat->EnableOuterShadowEffect();
    effectFormat->get_OuterShadowEffect()->set_Distance(10.0f);

    presentation->Save(u"theme-effects.pptx", SaveFormat::Pptx);
}

이 슬롯을 참조하는 도형에 대해 첫 번째 테마 선 스타일은 빨간색이 되고, 세 번째 테마 채우기 스타일은 단색 숲색 초록색이 되며, 세 번째 효과 스타일은 거리 10포인트의 외부 그림자를 얻게 됩니다. 정확한 시각 결과는 각 도형이 어떤 슬롯을 참조하고 있는지, 그리고 직접 서식이 테마를 재정의하는지에 따라 달라집니다.

Theme effect styles after changing line, fill, and shadow settings

유효한 단색 채우기가 테마 색상을 사용하는지 판단

채우기는 객체에 직접 저장될 수도 있고, 단락·레이아웃·마스터·테마 스타일·다른 서식 수준에서 상속될 수도 있습니다. IFillFormat::GetEffective를 호출해 해당 계층을 불변의 IFillFormatEffectiveData로 해결합니다. 먼저 IFillFormatEffectiveData::get_FillType를 확인하세요. FillType::Solid인 경우에만 단색 채우기 속성을 읽어야 합니다.

단색 채우기에 대해 IFillFormatEffectiveData::get_SolidFillColor는 상속·테마 조회·색상 변환이 적용된 후 최종 렌더링된 RGB 값을 반환합니다. IFillFormatEffectiveData::get_SolidFillSchemeColor는 해당 논리 SchemeColor 슬롯(예: Text1 또는 Accent6)을 반환합니다. SchemeColor::NotDefined는 유효 단색 채우기가 스킴 색상을 기반으로 하지 않음을 의미합니다. 테마 색상 또는 직접 RGB 색상만 사용하는 워크플로에서는 이 값이 직접 RGB 채우기를 식별합니다.

지역 IColorFormat::get_SchemeColor 값만으로 채우기를 분류하지 마세요. 예를 들어 텍스트 일부가 지역적으로 스킴 색상을 정의하지 않아 NotDefined가 될 수 있지만, 유효 채우기는 테마 색상을 상속받아 Text1이나 Accent6으로 해결될 수 있습니다. 반대로 get_SolidFillSchemeColor는 어떤 논리 테마 슬롯이 유효 색상을 만든 것인지를 알려 주지만, 해당 슬롯이 객체·단락·레이아웃·마스터·다른 수준 중 어디서 왔는지는 알려 주지 않습니다.

다음 예제는 프레젠테이션을 로드하고 도형 채우기와 텍스트‑부분 채우기를 모두 감사하며, 각 최종 RGB 값과 연관된 스킴 색상을 출력하고, 테마 색상 변경에 따라 동작하지 않을 단색 채우기를 표시합니다:

#include <DOM/FillType.h>
#include <DOM/IAutoShape.h>
#include <DOM/IColorFormat.h>
#include <DOM/IFillFormat.h>
#include <DOM/IFillFormatEffectiveData.h>
#include <DOM/IParagraph.h>
#include <DOM/IParagraphCollection.h>
#include <DOM/IPortion.h>
#include <DOM/IPortionCollection.h>
#include <DOM/IShape.h>
#include <DOM/ITextFrame.h>
#include <DOM/Presentation.h>
#include <DOM/SchemeColor.h>
#include <system/console.h>
#include <system/object_ext.h>
#include <system/string.h>

using namespace Aspose::Slides;
using namespace System;

auto auditFill = [](const String& objectName, const SharedPtr<IFillFormat>& localFill)
{
    auto effectiveFill = localFill->GetEffective();

    if (effectiveFill->get_FillType() != FillType::Solid)
    {
        Console::WriteLine(u"{0}: fill type = {1}; not a solid fill.", objectName, effectiveFill->get_FillType());
        return;
    }

    auto rgb = effectiveFill->get_SolidFillColor();
    auto effectiveSchemeColor = effectiveFill->get_SolidFillSchemeColor();
    auto localSchemeColor = localFill->get_SolidFillColor()->get_SchemeColor();

    Console::WriteLine(u"{0}: RGB = #{1:X2}{2:X2}{3:X2}", objectName, rgb.get_R(), rgb.get_G(), rgb.get_B());
    Console::WriteLine(u"{0}: local scheme = {1}, effective scheme = {2}", objectName, localSchemeColor, effectiveSchemeColor);

    if (effectiveSchemeColor == SchemeColor::NotDefined)
    {
        Console::WriteLine(u"{0}: direct RGB or another non-scheme fill; audit as theme-independent.", objectName);
    }
    else
    {
        Console::WriteLine(u"{0}: theme-dependent through {1}.", objectName, effectiveSchemeColor);
    }
};

auto presentation = MakeObject<Presentation>(u"input.pptx");

auto slideCount = presentation->get_Slides()->get_Count();
for (int32_t slideIndex = 0; slideIndex < slideCount; slideIndex++)
{
    auto slide = presentation->get_Slide(slideIndex);

    auto shapeCount = slide->get_Shapes()->get_Count();
    for (int32_t shapeIndex = 0; shapeIndex < shapeCount; shapeIndex++)
    {
        auto shape = slide->get_Shape(shapeIndex);
        auto shapeName = String::Format(u"Slide {0}, shape {1}", slideIndex + 1, shapeIndex + 1);
        auditFill(shapeName, shape->get_FillFormat());

        if (ObjectExt::Is<IAutoShape>(shape))
        {
            auto autoShape = ExplicitCast<IAutoShape>(shape);
            auto textFrame = autoShape->get_TextFrame();
            auto paragraphCount = textFrame->get_Paragraphs()->get_Count();
            for (int32_t paragraphIndex = 0; paragraphIndex < paragraphCount; paragraphIndex++)
            {
                auto paragraph = textFrame->get_Paragraph(paragraphIndex);

                auto portionCount = paragraph->get_Portions()->get_Count();
                for (int32_t portionIndex = 0; portionIndex < portionCount; portionIndex++)
                {
                    auto portion = paragraph->get_Portion(portionIndex);
                    auto portionName = String::Format(u"{0}, paragraph {1}, portion {2}", shapeName, paragraphIndex + 1, portionIndex + 1);
                    auditFill(portionName, portion->get_PortionFormat()->get_FillFormat());
                }
            }
        }
    }
}

NotDefined 분기는 테마 색상 슬롯 변화에 반응하지 않을 단색 채우기의 감사 목록을 제공합니다. 새로운 브랜드 팔레트를 적용해야 할 때 해당 객체들을 검토하세요. 보고된 RGB 값은 현재 외형을 보여 주고, 스킴 값은 그 외형이 테마와 연결돼 있는지 설명합니다.

유효‑포맷 객체는 스냅샷입니다. 프레젠테이션 테마, 테마 재정의 또는 상속된 서식을 변경한 후에는 다시 GetEffective를 호출하고 새로운 IFillFormatEffectiveData 객체를 읽은 뒤 색상을 비교하거나 보고하세요.

유효 테마 값 읽기

원시 테마 객체는 특정 수준에서 정의된 내용을 알려 주지만, 유효 값은 상속 및 로컬 재정의가 해결된 후 슬라이드·도형이 실제로 사용하는 값을 알려 줍니다. 슬라이드의 경우 IThemeable::CreateThemeEffective()를 호출합니다. 배경은 Background::GetEffective()를, 채우기는 FillFormat::GetEffective()를 사용합니다.

다음 예제는 슬라이드에서 유효 테마, 배경, 첫 번째 도형 채우기를 읽습니다:

#include <DOM/FillType.h>
#include <DOM/IBackground.h>
#include <DOM/IBackgroundEffectiveData.h>
#include <DOM/IFillFormat.h>
#include <DOM/IFillFormatEffectiveData.h>
#include <DOM/IFontsEffectiveData.h>
#include <DOM/IShape.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/Presentation.h>
#include <DOM/Theme/IFontSchemeEffectiveData.h>
#include <DOM/Theme/IThemeEffectiveData.h>
#include <system/console.h>

using namespace Aspose::Slides;
using namespace System;

auto presentation = MakeObject<Presentation>(u"input.pptx");
auto slide = presentation->get_Slide(0);
auto effectiveTheme = slide->CreateThemeEffective();
auto effectiveBackground = slide->get_Background()->GetEffective();

Console::WriteLine(u"Effective major Latin font: {0}", effectiveTheme->get_FontScheme()->get_Major()->get_LatinFont()->get_FontName());
Console::WriteLine(u"Effective minor Latin font: {0}", effectiveTheme->get_FontScheme()->get_Minor()->get_LatinFont()->get_FontName());
Console::WriteLine(u"Effective background fill type: {0}", effectiveBackground->get_FillFormat()->get_FillType());

if (slide->get_Shapes()->get_Count() > 0)
{
    auto effectiveFill = slide->get_Shape(0)->get_FillFormat()->GetEffective();
    Console::WriteLine(u"First shape effective fill type: {0}", effectiveFill->get_FillType());
    if (effectiveFill->get_FillType() == FillType::Solid)
    {
        Console::WriteLine(u"First shape effective fill color: {0}", effectiveFill->get_SolidFillColor());
    }
}

렌더링 진단·검증·비교를 위해 유효 데이터를 사용하세요. Presentation::get_MasterTheme()만 검사하면 마스터·레이아웃·슬라이드·도형 재정의 등 최종 외형을 바꾸는 요소를 놓칠 수 있습니다.

FAQ

외부 테마를 적용하면 프레젠테이션의 모든 슬라이드가 영향을 받나요?

아닙니다. IMasterSlide::ApplyExternalThemeToDependingSlides는 선택한 마스터에 종속된 슬라이드만 재할당합니다. 다른 마스터를 사용하는 슬라이드는 기존 테마를 유지합니다.

마스터를 변경하지 않고 단일 슬라이드에만 테마를 적용할 수 있나요?

가능합니다. 해당 슬라이드의 IOverrideThemeManager를 사용해 재정의 테마를 초기화하면 됩니다. 변경은 해당 슬라이드에만 적용되고, 다른 슬라이드는 기존 테마를 계속 상속받습니다.

한 프레젠테이션에서 다른 프레젠테이션으로 테마를 옮기는 가장 안전한 방법은?

슬라이드를 이동하면서 원본 외관을 보존하려면 원본 마스터를 대상에 복제하고, IMasterSlideCollection::AddClone()와 ISlideCollection::AddClone()을 사용해 슬라이드를 복제합니다. 이렇게 하면 마스터·레이아웃·테마가 함께 유지됩니다.

상속 및 재정의가 적용된 후 유효 값을 어떻게 확인할 수 있나요?

슬라이드·레이아웃 테마의 경우 IThemeable::CreateThemeEffective()를 사용하고, 포맷 객체(예: Background::GetEffective(), FillFormat::GetEffective())에 대한 해당 유효‑데이터 메서드를 사용하면 상속과 재정의가 적용된 최종 값을 반환합니다.

C++에서 스크립트별 테마 글꼴 관리