Applicera eller ändra bildlayouter i .NET

Vad den här sidan handlar om

Applicera, skapa och modifiera bildlayouter i Aspose.Slides för .NET, lägg till platshållare, ta bort oanvända layouter och styra fotnotssynlighet.

Översikt

En bildlayout definierar positioner och formatering för platshållare såsom titlar, text, bilder, diagram och tabeller. Att tillämpa en layout ger bilder en konsekvent struktur samtidigt som varje bild kan innehålla eget innehåll.

De vanligaste layouterna inkluderar:

Titelbild: Innehåller platshållare för titel och undertitel.
Titel och Innehåll: Innehåller en titelplatshållare och en allmän innehållsplatshållare.
Tom: Innehåller inga innehållsplatshållare och är användbar när varje form placeras manuellt.

Förstå layoutarv

En presentation har tre relaterade nivåer:

En masterbild definierar temat, gemensam formatering, bakgrunder och gemensamma objekt.
En layoutbild tillhör ett masterobjekt och definierar en särskild placering av platshållare.
En normal bild använder en layout och lagrar det innehåll som matats in för den bilden.

En normal bild ärver tema och formatering från sin layout, och layouten ärver från sitt masterobjekt. Ett värde som ställs in direkt på en normal bild åsidosätter det ärvda värdet på den nivån. När en normal bild skapas genereras dess platshållarformer från den valda layouten, medan innehållet som matas in i dessa platshållare tillhör den normala bilden.

Lägg till nödvändiga platshållare i en layout innan du skapar bilder från den. Att senare lägga till en ytterligare platshållare i en layout lägger inte automatiskt till motsvarande platshållarform i befintliga normala bilder.

Denna relation har två viktiga konsekvenser:

Att ändra ärvd formatering eller befintlig platshållargeometri i en layout kan uppdatera alla bilder som är beroende av den. Innan du redigerar en layout som redan används bör du undersöka dess beroende bilder och granska den resulterande presentationen.
En layout som fortfarande används av en bild kan inte tas bort. Tilldela först dess beroende bilder till en annan layout, eller ta bara bort oanvända layouter.

För mer information om den översta nivån i denna hierarki, se Slide Master.

För att dölja ärvda logotyper eller dekorativa masterformer på en bild eller via en gemensam layout, se Control the Visibility of Master Graphics. Exemplet jämför två bilder som använder samma master.

Välj och tillämpa en bildlayout

Använd en layouttyp när presentationen följer standarddefinitionerna för PowerPoint‑layouter. Layoutnamn kan redigeras av användaren och kan lokaleras, så namn‑baserad urval är mindre pålitligt om du inte styr källmallen.

Följande exempel söker efter Title and Content på den första mastern. Om den layouten inte är tillgänglig faller den med flit tillbaka till Blank. Den andra null‑kontrollen är nödvändig eftersom en presentation kan innehålla endast anpassade layouter. Den valda layouten tillämpas sedan på den första normala bilden via egenskapen ISlide.LayoutSlide.

using System;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("input.pptx");

var layoutSlides = presentation.Masters[0].LayoutSlides;
var targetLayout = layoutSlides.GetByType(SlideLayoutType.TitleAndObject) ?? layoutSlides.GetByType(SlideLayoutType.Blank);

if (targetLayout == null)
{
    throw new InvalidOperationException("The first master does not contain a suitable layout slide.");
}

presentation.Slides[0].LayoutSlide = targetLayout;
presentation.Save("output-with-new-layout.pptx", SaveFormat.Pptx);

Att ändra en bilds layout tar inte bort vanliga former som lagts till direkt på bilden. Däremot kan platshållarpositioner, ärvd formatering och samsynen mellan befintliga platshållare och den nya layouten förändras, så inspektera utdata när du byter mellan väsentligt olika layouter.

Lägg till en layoutbild

Urval och skapande är separata operationer. Det föregående exemplet väljer en befintlig layout; det skapar ingen. För att skapa en layout, anropa metoden IMasterLayoutSlideCollection.Add på det valda masterobjektets layoutsamling.

Följande exempel lägger alltid till en ny Title and Content‑layout med namnet Report Title and Content, och lägger sedan till en normal bild baserad på den. Layoutnamn måste vara unika inom samlingen.

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("input.pptx");

var masterSlide = presentation.Masters[0];
var reportLayout = masterSlide.LayoutSlides.Add(SlideLayoutType.TitleAndObject, "Report Title and Content");
presentation.Slides.AddEmptySlide(reportLayout);

presentation.Save("output-with-report-layout.pptx", SaveFormat.Pptx);

Lägg till en layout endast när mallen verkligen behöver en ytterligare återanvändbar struktur. Om en lämplig layout redan finns, välj och återanvänd den istället för att skapa en dubblett.

Lägg till platshållare i en layoutbild

Egenskapen ILayoutSlide.PlaceholderManager ger en ILayoutPlaceholderManager för att lägga till platshållarformer i en layout.

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 exempel verifierar att Blank‑layouten finns, lägger till fyra platshållare i den och skapar sedan en normal bild som använder den modifierade layouten. Ordningen är avsiktlig: platshållarna läggs till innan den normala bilden skapas, så att Aspose.Slides kan generera motsvarande platshållarformer på den bilden.

using System;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation();

var blankLayout = presentation.LayoutSlides.GetByType(SlideLayoutType.Blank);

if (blankLayout == null)
{
    throw new InvalidOperationException("The presentation does not contain a Blank layout slide.");
}

var placeholderManager = blankLayout.PlaceholderManager;
placeholderManager.AddContentPlaceholder(20, 20, 310, 270);
placeholderManager.AddVerticalTextPlaceholder(350, 20, 350, 270);
placeholderManager.AddChartPlaceholder(20, 310, 310, 180);
placeholderManager.AddTablePlaceholder(350, 310, 350, 180);

presentation.Slides.AddEmptySlide(blankLayout);
presentation.Save("output-with-placeholders.pptx", SaveFormat.Pptx);

Resultatet:

Platshållarna på layoutbilden

Warning

Att ändra ärvd formatering eller geometri för befintliga layout‑platshållare kan påverka beroende bilder. En nyligen tillagd layout‑platshållare fylls inte retroaktivt i befintliga normala bilder. Testa layout‑ändringar på en kopia av presentationen och inspektera varje beroende bild.

Ta bort oanvända layoutbilder

Använd metoden Compress.RemoveUnusedLayoutSlides för att ta bort layouter som ingen normal bild refererar till. Metoden lämnar intakta de layouter som fortfarande är i bruk.

using Aspose.Slides;
using Aspose.Slides.Export;
using Aspose.Slides.LowCode;

using var presentation = new Presentation("input.pptx");

Compress.RemoveUnusedLayoutSlides(presentation);
presentation.Save("output-without-unused-layouts.pptx", SaveFormat.Pptx);

För att ta bort en specifik layout, använd först dess egenskap HasDependingSlides eller metod GetDependingSlides. Tilldela om eventuella beroende bilder innan du anropar ILayoutSlide.Remove. Att försöka ta bort en layout som används kastar ett PptxEditException.

Styr fotnotssynlighet på en layoutbild

En layout har sina egna fotnot-, bildnummer- och datum‑tid‑platshållare. Använd egenskapen ILayoutSlide.HeaderFooterManager för att styra dessa platshållare för en layout. Detta är användbart när exempelvis innehållslayouter ska visa fotnoter men titel‑layouter inte ska.

Följande exempel väljer en layout på ett säkert sätt och gör dess fotnotelement synliga:

using System;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("input.pptx");

var layoutSlide = presentation.LayoutSlides.GetByType(SlideLayoutType.TitleAndObject) ?? presentation.LayoutSlides.GetByType(SlideLayoutType.Blank);

if (layoutSlide == null)
{
    throw new InvalidOperationException("The presentation does not contain a suitable layout slide.");
}

var headerFooterManager = layoutSlide.HeaderFooterManager;
headerFooterManager.SetFooterVisibility(true);
headerFooterManager.SetSlideNumberVisibility(true);
headerFooterManager.SetDateTimeVisibility(true);
headerFooterManager.SetFooterText("Footer text");
headerFooterManager.SetDateTimeText("Date and time text");

presentation.Save("output-with-layout-footers.pptx", SaveFormat.Pptx);

Styr fotnotssynlighet på en master och dess underliggande layouter

För att tillämpa enhetliga fotnotinställningar över en master‑hierarki, använd egenskapen IMasterSlide.HeaderFooterManager. Spridningsmetoderna i IMasterSlideHeaderFooterManager verkar på mastern samt dess beroende layout‑bilder och normala bilder; de riktar sig inte endast till en enda normal bild.

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("input.pptx");

var headerFooterManager = presentation.Masters[0].HeaderFooterManager;
headerFooterManager.SetFooterAndChildFootersVisibility(true);
headerFooterManager.SetSlideNumberAndChildSlideNumbersVisibility(true);
headerFooterManager.SetDateTimeAndChildDateTimesVisibility(true);
headerFooterManager.SetFooterAndChildFootersText("Footer text");
headerFooterManager.SetDateTimeAndChildDateTimesText("Date and time text");

presentation.Save("output-with-master-footers.pptx", SaveFormat.Pptx);

FAQ

Vad är skillnaden mellan en masterbild och en layoutbild?

En masterbild definierar presentationens tema och gemensam formatering. En layoutbild tillhör en master och definierar en återanvändbar placering av platshållare. Normala bilder använder dessa layouter och lagrar bildspecifikt innehåll.

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

Ja. Lägg till en kopia i destinationssamlingen med metoden AddClone. När du kopierar mellan presentationer, verifiera även teckensnitt, teman, bilder och andra resurser som används av källlayouten.

Vad händer när jag ändrar en layout som redan är i bruk?

Beroende bilder ärver layoutändringarna om de inte överskuggar den påverkade formateringen eller objekten lokalt. Platshållargeometri och ärvd stil kan därför förändras på många bilder samtidigt. Använd GetDependingSlides för att identifiera de påverkade bilderna innan du redigerar layouten.

Vad händer om jag tar bort en layout som fortfarande är i bruk?

Aspose.Slides kastar ett PptxEditException. Tilldela först om de beroende bilderna, eller använd RemoveUnusedLayoutSlides för att bara ta bort orefererade layouter.

Jämför presentationsbilder i .NET Ändra presentationens bildstorlek i .NET