Lay-outs voor dia's toepassen of wijzigen in .NET

Waar deze pagina over gaat

Dia-layouts toepassen, maken en wijzigen in Aspose.Slides voor .NET, placeholders toevoegen, ongebruikte layout verwijderen en de zichtbaarheid van de voettekst beheren.

Overzicht

Een slide‑lay‑out definieert de posities en opmaak van tijdelijke aanduidingen zoals titels, tekst, afbeeldingen, grafieken en tabellen. Het toepassen van een lay‑out geeft dia’s een consistente structuur terwijl elke dia zijn eigen inhoud kan bevatten.

De meest voorkomende lay‑outs zijn:

Titel‑dia: Bevat tijdelijke aanduidingen voor titel en ondertitel.
Titel en inhoud: Bevat een titel‑placeholder en een algemene inhouds‑placeholder.
Leeg: Bevat geen inhouds‑placeholders en is handig wanneer elke vorm handmatig wordt gepositioneerd.

Begrijp layout‑erfelijkheid

Een presentatie heeft drie gerelateerde niveaus:

Een master‑slide definieert het thema, gedeelde opmaak, achtergronden en gemeenschappelijke objecten.
Een layout‑slide behoort tot een master en definieert een specifieke rangschikking van placeholders.
Een normale slide gebruikt één lay‑out en slaat de ingevoerde inhoud voor die dia op.

Een normale dia erft thema en opmaak van zijn lay‑out, en de lay‑out erft van zijn master. Een waarde die rechtstreeks op een normale dia wordt ingesteld, overschrijft de geërfde waarde op dat niveau. Wanneer een normale dia wordt aangemaakt, worden de placeholder‑vormen gegenereerd vanuit de geselecteerde lay‑out, terwijl de ingevoerde inhoud in die placeholders behoort tot de normale dia.

Voeg verplichte placeholders toe aan een lay‑out voordat je dia’s ervan maakt. Een later toegevoegde placeholder aan een lay‑out voegt niet automatisch een overeenkomstige placeholder‑vorm toe aan bestaande normale dia’s.

Deze relatie heeft twee belangrijke consequenties:

Het wijzigen van geërfde opmaak of bestaande placeholder‑geometrie in een lay‑out kan elke dia die ervan afhankelijk is bijwerken. Controleer vóór het bewerken van een lay‑out die al in gebruik is de afhankelijke dia’s en evalueer de resulterende presentatie.
Een lay‑out die nog door een dia wordt gebruikt, kan niet worden verwijderd. Ken eerst de afhankelijke dia’s opnieuw toe aan een andere lay‑out, of verwijder alleen ongebruikte lay‑outs.

Voor meer informatie over het hoogste niveau van deze hiërarchie, zie Slide Master.

Selecteer en pas een slide‑lay‑out toe

Gebruik een lay‑outtype wanneer de presentatie standaard PowerPoint‑lay‑outdefinities volgt. Lay‑outnamen zijn door de gebruiker bewerkbaar en kunnen worden gelokaliseerd, dus naam‑gebaseerde selectie is minder betrouwbaar tenzij je de bron‑template beheert.

Het volgende voorbeeld zoekt naar Title and Content op de eerste master. Als die lay‑out niet beschikbaar is, valt het bewust terug op Blank. De tweede null‑check is nodig omdat een presentatie uitsluitend aangepaste lay‑outs kan bevatten. De geselecteerde lay‑out wordt vervolgens toegepast op de eerste normale dia via de ISlide.LayoutSlide‑eigenschap.

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

Het wijzigen van de lay‑out van een dia verwijdert niet de gewone vormen die direct aan de dia zijn toegevoegd. Placeholder‑posities, geërfde opmaak en de correspondentie tussen bestaande placeholders en de nieuwe lay‑out kunnen echter wijzigen, dus inspecteer de output bij het wisselen tussen wezenlijk verschillende lay‑outs.

Voeg een layout‑slide toe

Selectie en creatie zijn afzonderlijke handelingen. Het vorige voorbeeld selecteert een bestaande lay‑out; het maakt er geen aan. Om een lay‑out te maken, roep je de IMasterLayoutSlideCollection.Add‑methode aan op de lay‑outcollectie van de doel‑master.

Het volgende voorbeeld voegt steeds een nieuwe Title and Content‑lay‑out toe met de naam Report Title and Content, en voegt daarna een normale dia toe die ervan afgeleid is. Lay‑outnamen moeten binnen de collectie uniek zijn.

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

Voeg alleen een lay‑out toe wanneer de template werkelijk een extra herbruikbare structuur nodig heeft. Als er al een passende lay‑out bestaat, selecteer en hergebruik die dan in plaats van een duplicaat aan te maken.

Voeg placeholders toe aan een layout‑slide

De ILayoutSlide.PlaceholderManager‑eigenschap biedt een ILayoutPlaceholderManager voor het toevoegen van placeholder‑vormen aan een lay‑out.

PowerPoint‑placeholder	`ILayoutPlaceholderManager` Method
	`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)`

Het volgende voorbeeld controleert of de Blank‑lay‑out bestaat, voegt er vier placeholders aan toe en maakt vervolgens een normale dia die de gewijzigde lay‑out gebruikt. De volgorde is opzettelijk: de placeholders worden toegevoegd vóór het aanmaken van de normale dia, zodat Aspose.Slides de overeenkomstige placeholder‑vormen op die dia kan genereren.

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

Het resultaat:

The placeholders on the layout slide

Waarschuwing

Het wijzigen van geërfde opmaak of de geometrie van bestaande lay‑out‑placeholders kan afhankelijke dia’s beïnvloeden. Een nieuw toegevoegde layout‑placeholder wordt niet automatisch teruggevoerd naar bestaande normale dia’s. Test lay‑out‑wijzigingen op een kopie van de presentatie en controleer elke afhankelijke dia.

Verwijder ongebruikte layout‑slides

Gebruik de Compress.RemoveUnusedLayoutSlides‑methode om lay‑outs te verwijderen die door geen enkele normale dia worden gerefereerd. De methode laat lay‑outs die nog in gebruik zijn ongewijzigd.

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

Om één specifieke lay‑out te verwijderen, controleer eerst de HasDependingSlides‑eigenschap of de GetDependingSlides‑methode. Ken eventuele afhankelijke dia’s opnieuw toe voordat je ILayoutSlide.Remove aanroept. Het proberen te verwijderen van een gebruikte lay‑out veroorzaakt een PptxEditException.

Regel de zichtbaarheid van voetteksten op een layout‑slide

Een lay‑out heeft zijn eigen voettekst‑, dia‑nummer‑ en datum‑tijd‑placeholders. Gebruik de ILayoutSlide.HeaderFooterManager‑eigenschap om die placeholders voor één lay‑out te regelen. Dit is handig wanneer bijvoorbeeld inhoud‑lay‑outs voetteksten tonen maar titel‑lay‑outs niet.

Het volgende voorbeeld selecteert veilig een lay‑out en maakt de voettekstelementen zichtbaar:

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

Regel de zichtbaarheid van voetteksten op een master en zijn onderliggende lay‑outs

Om consistente voettekstinstellingen toe te passen over een meester‑hiërarchie, gebruik je de IMasterSlide.HeaderFooterManager‑eigenschap. De propagatiemethoden van IMasterSlideHeaderFooterManager werken op de master en zijn afhankelijke lay‑out‑slides en normale slides; ze richten zich niet alleen op één normale slide.

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

Wat is het verschil tussen een master‑slide en een layout‑slide?

Een master‑slide definieert het thema en de gedeelde opmaak van de presentatie. Een layout‑slide behoort tot een master en definieert een herbruikbare rangschikking van placeholders. Normale dia’s gebruiken die lay‑outs en slaan dia‑specifieke inhoud op.

Kan ik een layout‑slide van de ene presentatie naar de andere kopiëren?

Ja. Voeg een kopie toe aan de doel‑collectie met de AddClone‑methode. Bij het kopiëren tussen presentaties moet je bovendien fonts, thema’s, afbeeldingen en andere bronnen die door de bron‑lay‑out worden gebruikt verifiëren.

Wat gebeurt er als ik een lay‑out wijzig die al in gebruik is?

Afhankelijke dia’s erven de lay‑out‑wijzigingen tenzij ze de betrokken opmaak of objecten lokaal overschrijven. Placeholder‑geometrie en geërfde styling kunnen daardoor op veel dia’s tegelijk veranderen. Gebruik GetDependingSlides om de getroffen dia’s te identificeren vóór je de lay‑out bewerkt.

Wat gebeurt er als ik een lay‑out verwijder die nog in gebruik is?

Aspose.Slides gooit een PptxEditException. Ken de afhankelijke dia’s eerst opnieuw toe, of gebruik RemoveUnusedLayoutSlides om alleen niet‑gerefereerde lay‑outs te verwijderen.

Presentatiedia's vergelijken in .NET Diaformaat van de presentatie wijzigen in .NET