Applicera eller ändra bildlayouter i C++

Vad den här sidan handlar om

Hantera och anpassa bildlayouter i Aspose.Slides för C++. Utforska layouttyper, kontroll av platshållare och fotovisibilitet genom C++-kodexempel.

Introduktion

En bildlayout definierar arrangemanget av platshållarbokser och formatering för innehållet på en bild. Den styr vilka platshållare som är tillgängliga och var de visas. Bildlayouter hjälper dig att skapa presentationer snabbt och konsekvent—oavsett om du skapar något enkelt eller mer komplext. Några av de vanligaste bildlayouterna i PowerPoint inkluderar:

Titelbildslayout – Inkluderar två textplatshållare: en för titel och en för undertitel.

Titel och innehållslayout – Har en mindre titelplatshållare högst upp och en större nedanför för huvudinnehåll (såsom text, punktlistor, diagram, bilder och mer).

Tom layout – Innehåller ingen platshållare, vilket ger dig full kontroll att designa bilden från början.

Bildlayouter är en del av en bildmaster, som är den översta bilden som definierar layoutstilar för presentationen. Du kan komma åt och ändra layoutbilder via bildmastern—antingen efter deras typ, namn eller unika ID. Alternativt kan du redigera en specifik layoutbild direkt i presentationen.

För att arbeta med bildlayouter i Aspose.Slides för Android kan du använda:

Metoder som get_LayoutSlides och get_Masters under klassen Presentation
Typer som ILayoutSlide, IMasterLayoutSlideCollection, ILayoutPlaceholderManager, och ILayoutSlideHeaderFooterManager

Info

För att lära dig mer om att arbeta med masternbilder, läs artikeln Slide Master.

Lägg till bildlayouter i presentationer

För att anpassa utseendet och strukturen på dina bilder kan du behöva lägga till nya layoutbilder i en presentation. Aspose.Slides för Android låter dig kontrollera om en specifik layout redan finns, lägga till en ny om det behövs, och använda den för att infoga bilder baserade på den layouten.

Skapa en instans av klassen Presentation.
Åtkomst till IMasterLayoutSlideCollection.
Kontrollera om den önskade layoutbilden redan finns i samlingen. Om den inte finns, lägg till den layoutbild du behöver.
Lägg till en tom bild baserad på den nya layoutbilden.
Spara presentationen.

Följande C++-kod demonstrerar hur man lägger till en bildlayout i en PowerPoint-presentation:

// Skapa en instans av Presentation-klassen som representerar en PowerPoint-fil.
auto presentation = MakeObject<Presentation>(u"Sample.pptx");

// Go through the layout slide types to select a layout slide.
auto layoutSlides = presentation->get_Master(0)->get_LayoutSlides();
SharedPtr<ILayoutSlide> layoutSlide;
if (layoutSlides->GetByType(SlideLayoutType::TitleAndObject) != nullptr)
{
    layoutSlide = layoutSlides->GetByType(SlideLayoutType::TitleAndObject);
}
else if (layoutSlides->GetByType(SlideLayoutType::Title) != nullptr)
{
    layoutSlide = layoutSlides->GetByType(SlideLayoutType::Title);
}

if (layoutSlide == nullptr)
{
    // Ett scenario där presentationen inte innehåller alla layouttyper.
    // Presentationsfilen innehåller endast tomma och anpassade layouttyper.
    // Dock kan layoutbilder med anpassade typer ha igenkännbara namn,
    // såsom "Title", "Title and Content", etc., som kan användas för att välja layoutbild.
    // Du kan även förlita dig på en uppsättning av platshållarformstyper.
    // Till exempel bör en Title-bild bara ha Title-platshållartypen, osv.
    for (int i = 0; i < layoutSlides->get_Count(); i++)
    {
        auto titleAndObjectLayoutSlide = layoutSlides->idx_get(i);

        if (titleAndObjectLayoutSlide->get_Name().Equals(u"Title and Object"))
        {
            layoutSlide = titleAndObjectLayoutSlide;
            break;
        }
    }

    if (layoutSlide == nullptr)
    {
        for (int i = 0; i < layoutSlides->get_Count(); i++)
        {
            auto titleLayoutSlide = layoutSlides->idx_get(i);

            if (titleLayoutSlide->get_Name() == u"Title")
            {
                layoutSlide = titleLayoutSlide;
                break;
            }
        }

        if (layoutSlide == nullptr)
        {
            layoutSlide = layoutSlides->GetByType(SlideLayoutType::Blank);
            if (layoutSlide == nullptr)
            {
                layoutSlide = layoutSlides->Add(SlideLayoutType::TitleAndObject, u"Title and Object");
            }
        }
    }
}

// Lägg till en tom bild med den tillagda layoutbilden.
presentation->get_Slides()->InsertEmptySlide(0, layoutSlide);

// Spara presentationen till disk.
presentation->Save(u"Output.pptx", SaveFormat::Pptx);
presentation->Dispose();

Ta bort oanvända layoutbilder

Aspose.Slides tillhandahåller metoden RemoveUnusedLayoutSlides från klassen Compress för att låta dig ta bort oönskade och oanvända layoutbilder.

Följande C++-kod visar hur man tar bort en layoutbild från en PowerPoint-presentation:

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

Compress::RemoveUnusedLayoutSlides(presentation);

presentation->Save(u"Output.pptx", SaveFormat::Pptx);
presentation->Dispose();

Lägg till platshållare i bildlayouter

Aspose.Slides tillhandahåller metoden ILayoutSlide.get_PlaceholderManager som låter dig lägga till nya platshållare i en layoutbild.

Denna manager innehåller metoder för följande platshållartyper:

PowerPoint‑platshållare	ILayoutPlaceholderManager Metod
	AddContentPlaceholder(float x, float y, float width, float height)
	AddVerticalContentPlaceholder(float x, float y, float width, float height)
	AddTextPlaceholder(float x, float y, float width, float height)
	AddVerticalTextPlaceholder(float x, float y, float width, float height)
	AddPicturePlaceholder(float x, float y, float width, float height)
	AddChartPlaceholder(float x, float y, float width, float height)
	AddTablePlaceholder(float x, float y, float width, float height)
	AddSmartArtPlaceholder(float x, float y, float width, float height)
	AddMediaPlaceholder(float x, float y, float width, float height)
	AddOnlineImagePlaceholder(float x, float y, float width, float height)

Följande C++-kod demonstrerar hur man lägger till nya platshållarformer i den tomma layoutbilden:

auto presentation = MakeObject<Presentation>();

// Hämta den tomma layoutbilden.
auto layout = presentation->get_LayoutSlides()->GetByType(SlideLayoutType::Blank);

// Hämta platshållarhanteraren för layoutbilden.
auto placeholderManager = layout->get_PlaceholderManager();

// Lägg till olika platshållare på den tomma layoutbilden.
placeholderManager->AddContentPlaceholder(20, 20, 310, 270);
placeholderManager->AddVerticalTextPlaceholder(350, 20, 350, 270);
placeholderManager->AddChartPlaceholder(20, 310, 310, 180);
placeholderManager->AddTablePlaceholder(350, 310, 350, 180);

// Lägg till en ny bild med den tomma layouten.
auto newSlide = presentation->get_Slides()->AddEmptySlide(layout);

presentation->Save(u"Placeholders.pptx", SaveFormat::Pptx);
presentation->Dispose();

Resultatet:

Platshållarna på layoutbilden

Ställ in sidfotssynlighet för en layoutbild

I PowerPoint-presentationer kan fotoelement som datum, bildnummer och anpassad text visas eller döljas beroende på bildlayout. Aspose.Slides för Android låter dig styra synligheten för dessa fotoplacshållare. Detta är användbart när du vill att vissa layouter ska visa fotoinformation medan andra förblir rena och minimal.

Skapa en instans av klassen Presentation.
Hämta en referens till en layoutbild enligt dess index.
Ställ in bildens fotoplacshållare som synlig.
Ställ in bildnummer‑placshållare som synlig.
Ställ in datum‑tid‑placshållare som synlig. Spara presentationen.

Följande C++-kod visar hur man ställer in synligheten för en bildfot och utför relaterade uppgifter:

auto presentation = MakeObject<Presentation>(u"Presentation.ppt");
auto headerFooterManager = presentation->get_LayoutSlides()->idx_get(0)->get_HeaderFooterManager();

if (!headerFooterManager->get_IsFooterVisible())
{
    headerFooterManager->SetFooterVisibility(true);
}

if (!headerFooterManager->get_IsSlideNumberVisible())
{
    headerFooterManager->SetSlideNumberVisibility(true);
}

if (!headerFooterManager->get_IsDateTimeVisible())
{
    headerFooterManager->SetDateTimeVisibility(true);
}

headerFooterManager->SetFooterText(u"Footer text");
headerFooterManager->SetDateTimeText(u"Date and time text");

presentation->Save(u"Presentation.ppt", SaveFormat::Pptx);
presentation->Dispose();

Ställ in underordnad fotovisibilitet för en bild

I PowerPoint-presentationer kan fotoelement som datum, bildnummer och anpassad text kontrolleras på masternivå för att säkerställa konsistens över alla layoutbilder. Aspose.Slides för Android möjliggör att ställa in synlighet och innehåll för dessa fotoplacshållare på mastern och sprida dessa inställningar till alla underordnade layoutbilder. Detta tillvägagångssätt säkerställer enhetlig fotoinformation i hela presentationen.

Skapa en instans av klassen Presentation.
Hämta en referens till mastern enligt dess index.
Ställ in masterns och alla underordnade fotoplacshållare som synliga.
Ställ in masterns och alla underordnade bildnummer‑placshållare som synliga.
Ställ in masterns och alla underordnade datum‑tid‑placshållare som synliga.
Spara presentationen.

Följande C++-kod demonstrerar denna operation:

auto presentation = MakeObject<Presentation>();

auto headerFooterManager = presentation->get_Master(0)->get_HeaderFooterManager();

headerFooterManager->SetFooterAndChildFootersVisibility(true);
headerFooterManager->SetSlideNumberAndChildSlideNumbersVisibility(true);
headerFooterManager->SetDateTimeAndChildDateTimesVisibility(true);

headerFooterManager->SetFooterAndChildFootersText(u"Footer text");
headerFooterManager->SetDateTimeAndChildDateTimesText(u"Date and time text");

presentation->Save(u"Output.pptx", SaveFormat::Pptx);
presentation->Dispose();

FAQ

Vad är skillnaden mellan en masternbild och en layoutbild?

En masternbild definierar det övergripande temat och standardformatering, medan layoutbilder definierar specifika arrangemang av platshållare för olika typer av innehåll.

Kan jag kopiera en layoutbild från en presentation till en annan?

Ja, du kan klona en layoutbild från en presentations layoutsamling, som är åtkomlig via metoden get_LayoutSlides, och infoga den i en annan presentation med metoden AddClone.

Vad händer om jag tar bort en layoutbild som fortfarande används av en bild?

Om du försöker ta bort en layoutbild som fortfarande refereras av minst en bild i presentationen, kommer Aspose.Slides att kasta ett PptxEditException. För att undvika detta, använd RemoveUnusedLayoutSlides som säkert tar bort endast de layoutbilder som inte används.

Jämför presentationsbilder i C++ Ändra bildstorlek i presentationen i C++