Toepassen of wijzigen van dia-indelingen in Python

Overzicht

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

De meest voorkomende indelingen zijn:

  • Titeldia: Bevat tijdelijke aanduidingen voor titel en ondertitel.
  • Titel en Inhoud: Bevat een tijdelijke aanduiding voor de titel en een algemene tijdelijke aanduiding voor inhoud.
  • Leeg: Bevat geen tijdelijke aanduidingen en is handig wanneer elke vorm handmatig wordt gepositioneerd.

Begrijp erfelijkheid van indelingen

Een presentatie heeft drie gerelateerde niveaus:

  1. Een masterdia definieert het thema, gedeelde opmaak, achtergronden en gemeenschappelijke objecten.
  2. Een indelingsdia behoort tot een master en definieert een specifieke rangschikking van tijdelijke aanduidingen.
  3. Een normale dia gebruikt één indeling en slaat de ingevoerde inhoud voor die dia op.

Een normale dia erft thema en opmaak van zijn indeling, en de indeling 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 tijdelijke aanduidingsvormen gegenereerd vanuit de geselecteerde indeling, terwijl de ingevoerde inhoud in die tijdelijke aanduidingen tot de normale dia behoort.

Voeg verplichte tijdelijke aanduidingen toe aan een indeling voordat je er dia’s van maakt. Een later toegevoegde tijdelijke aanduiding aan een indeling wordt niet automatisch toegevoegd aan bestaande normale dia’s.

Deze relatie heeft twee belangrijke consequenties:

  • Het wijzigen van geërfde opmaak of bestaande placeholder‑geometry op een indeling kan elke dia die ervan afhankelijk is bijwerken. Inspecteer de afhankelijke dia’s en bekijk de resulterende presentatie voordat je een al in gebruik zijnde indeling bewerkt.
  • Een indeling die nog door een dia wordt gebruikt, kan niet worden verwijderd. Ken eerst de afhankelijke dia’s opnieuw toe aan een andere indeling, of verwijder alleen ongebruikte indelingen.

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

Selecteer en pas een dia‑indeling toe

Gebruik een indelingstype wanneer de presentatie de standaard PowerPoint‑indelingsdefinities volgt. Indelingsnamen zijn door de gebruiker bewerkbaar en kunnen worden gelokaliseerd, dus selectie op naam is minder betrouwbaar tenzij je de bron‑sjabloon beheert.

Het volgende voorbeeld zoekt naar Title and Content op de eerste master. Als die indeling niet beschikbaar is, valt het doelbewust terug op Blank. De tweede null‑controle is nodig omdat een presentatie alleen aangepaste indelingen kan bevatten. De geselecteerde indeling wordt vervolgens toegepast op de eerste normale dia via de Slide.layout_slide‑eigenschap.

import aspose.slides as slides

with slides.Presentation("input.pptx") as presentation:
    layout_slides = presentation.masters[0].layout_slides
    target_layout = layout_slides.get_by_type(slides.SlideLayoutType.TITLE_AND_OBJECT)

    if target_layout is None:
        target_layout = layout_slides.get_by_type(slides.SlideLayoutType.BLANK)

    if target_layout is None:
        raise RuntimeError("The first master does not contain a suitable layout slide.")

    presentation.slides[0].layout_slide = target_layout
    presentation.save("output-with-new-layout.pptx", slides.export.SaveFormat.PPTX)

Het wijzigen van de indeling van een dia verwijdert niet de gewone vormen die rechtstreeks aan de dia zijn toegevoegd. Echter, de posities van tijdelijke aanduidingen, geërfde opmaak en de overeenkomst tussen bestaande placeholders en de nieuwe indeling kunnen veranderen, dus inspecteer de uitvoer bij het wisselen tussen wezenlijk verschillende indelingen.

Voeg een indelingsdia toe

Selectie en creatie zijn afzonderlijke bewerkingen. Het vorige voorbeeld selecteert een bestaande indeling; het maakt er geen nieuwe aan. Om een indeling te maken, roep je de MasterLayoutSlideCollection.add‑methode aan op de lay‑outcollectie van de doel‑master.

Het volgende voorbeeld voegt steeds een nieuwe Title and Content‑indeling toe met de naam Report Title and Content, en voegt vervolgens een normale dia toe die daarop is gebaseerd. Indelingsnamen moeten uniek zijn binnen de collectie.

import aspose.slides as slides

with slides.Presentation("input.pptx") as presentation:
    master_slide = presentation.masters[0]
    report_layout = master_slide.layout_slides.add(slides.SlideLayoutType.TITLE_AND_OBJECT, "Report Title and Content")
    presentation.slides.add_empty_slide(report_layout)

    presentation.save("output-with-report-layout.pptx", slides.export.SaveFormat.PPTX)

Voeg alleen een indeling toe wanneer de sjabloon echt een extra herbruikbare structuur nodig heeft. Als er al een geschikte indeling bestaat, selecteer en hergebruik die in plaats van een duplicaat te maken.

Voeg tijdelijke aanduidingen toe aan een indelingsdia

De LayoutSlide.placeholder_manager‑eigenschap biedt een LayoutPlaceholderManager voor het toevoegen van placeholder‑vormen aan een indeling.

PowerPoint tijdelijke aanduiding LayoutPlaceholderManager Methode
Inhoud add_content_placeholder(x, y, width, height)
Inhoud (Verticaal) add_vertical_content_placeholder(x, y, width, height)
Tekst add_text_placeholder(x, y, width, height)
Tekst (Verticaal) add_vertical_text_placeholder(x, y, width, height)
Afbeelding add_picture_placeholder(x, y, width, height)
Grafiek add_chart_placeholder(x, y, width, height)
Tabel add_table_placeholder(x, y, width, height)
SmartArt add_smart_art_placeholder(x, y, width, height)
Media add_media_placeholder(x, y, width, height)
Online‑afbeelding add_online_image_placeholder(x, y, width, height)

Het volgende voorbeeld controleert of de Blank‑indeling bestaat, voegt er vier placeholders aan toe en maakt daarna een normale dia die de gewijzigde indeling gebruikt. De volgorde is opzettelijk: de placeholders worden toegevoegd vóórdat de normale dia wordt aangemaakt, zodat Aspose.Slides de overeenkomstige placeholder‑vormen op die dia kan genereren.

import aspose.slides as slides

with slides.Presentation() as presentation:
    blank_layout = presentation.layout_slides.get_by_type(slides.SlideLayoutType.BLANK)

    if blank_layout is None:
        raise RuntimeError("The presentation does not contain a Blank layout slide.")

    placeholder_manager = blank_layout.placeholder_manager
    placeholder_manager.add_content_placeholder(20, 20, 310, 270)
    placeholder_manager.add_vertical_text_placeholder(350, 20, 350, 270)
    placeholder_manager.add_chart_placeholder(20, 310, 310, 180)
    placeholder_manager.add_table_placeholder(350, 310, 350, 180)

    presentation.slides.add_empty_slide(blank_layout)
    presentation.save("output-with-placeholders.pptx", slides.export.SaveFormat.PPTX)

Het resultaat:

De placeholders op de indelingsdia

Verwijder ongebruikte indelingsdia’s

Gebruik de Compress.remove_unused_layout_slides‑methode om indelingen te verwijderen die door geen enkele normale dia worden gerefereerd. De methode laat indelingen die nog in gebruik zijn onaangeroerd.

import aspose.slides as slides

with slides.Presentation("input.pptx") as presentation:
    slides.lowcode.Compress.remove_unused_layout_slides(presentation)
    presentation.save("output-without-unused-layouts.pptx", slides.export.SaveFormat.PPTX)

Om één specifieke indeling te verwijderen, controleer eerst de has_depending_slides‑eigenschap of de get_depending_slides‑methode. Ken eventuele afhankelijke dia’s opnieuw toe voordat je LayoutSlide.remove aanroept. Het proberen te verwijderen van een gebruikte indeling veroorzaakt een PptxEditException.

Regel de zichtbaarheid van de voettekst op een indelingsdia

Een indeling heeft zijn eigen voettekst‑, dia‑nummer‑ en datum‑tijd‑placeholders. Gebruik de LayoutSlide.header_footer_manager‑eigenschap om die placeholders voor één indeling te regelen. Dit is handig wanneer bijvoorbeeld inhoud‑indelingen voetteksten moeten tonen maar titel‑indelingen niet.

Het volgende voorbeeld selecteert veilig een indeling en maakt de voettekstelementen zichtbaar:

import aspose.slides as slides

with slides.Presentation("input.pptx") as presentation:
    layout_slide = presentation.layout_slides.get_by_type(slides.SlideLayoutType.TITLE_AND_OBJECT)

    if layout_slide is None:
        layout_slide = presentation.layout_slides.get_by_type(slides.SlideLayoutType.BLANK)

    if layout_slide is None:
        raise RuntimeError("The presentation does not contain a suitable layout slide.")

    header_footer_manager = layout_slide.header_footer_manager
    header_footer_manager.set_footer_visibility(True)
    header_footer_manager.set_slide_number_visibility(True)
    header_footer_manager.set_date_time_visibility(True)
    header_footer_manager.set_footer_text("Footer text")
    header_footer_manager.set_date_time_text("Date and time text")

    presentation.save("output-with-layout-footers.pptx", slides.export.SaveFormat.PPTX)

Regel de zichtbaarheid van de voettekst op een master en zijn onderliggende indelingen

Om consistente voettekst‑instellingen door een masterhiërarchie heen toe te passen, gebruik je de MasterSlide.header_footer_manager‑eigenschap. De propagatiemethoden van MasterSlideHeaderFooterManager werken op de master en zijn afhankelijke indelings‑ en normale dia’s; ze richten zich niet alleen op één normale dia.

import aspose.slides as slides

with slides.Presentation("input.pptx") as presentation:
    header_footer_manager = presentation.masters[0].header_footer_manager
    header_footer_manager.set_footer_and_child_footers_visibility(True)
    header_footer_manager.set_slide_number_and_child_slide_numbers_visibility(True)
    header_footer_manager.set_date_time_and_child_date_times_visibility(True)
    header_footer_manager.set_footer_and_child_footers_text("Footer text")
    header_footer_manager.set_date_time_and_child_date_times_text("Date and time text")

    presentation.save("output-with-master-footers.pptx", slides.export.SaveFormat.PPTX)

FAQ

Wat is het verschil tussen een masterdia en een indelingsdia?

Een masterdia definieert het thema en de gedeelde opmaak van de presentatie. Een indelingsdia behoort tot een master en definieert één herbruikbare rangschikking van placeholders. Normale dia’s gebruiken die indelingen en slaan dia‑specifieke inhoud op.

Kan ik een indelingsdia van de ene presentatie naar de andere kopiëren?

Ja. Voeg een kopie toe aan de bestemmingscollectie met de add_clone‑methode. Bij het kopiëren tussen presentaties moet je ook lettertypen, themas, afbeeldingen en andere bronnen die door de bron‑indeling worden gebruikt verifiëren.

Wat gebeurt er wanneer ik een indeling wijzig die al in gebruik is?

Afhankelijke dia’s erven de indelingswijzigingen tenzij ze de getroffen opmaak of objecten lokaal overschrijven. Placeholder‑geometry en geërfde styling kunnen daardoor tegelijk op veel dia’s veranderen. Gebruik get_depending_slides om de getroffen dia’s te identificeren voordat je de indeling bewerkt.

Wat gebeurt er als ik een indeling verwijder die nog in gebruik is?

Aspose.Slides veroorzaakt een PptxEditException. Ken eerst de afhankelijke dia’s opnieuw toe, of gebruik remove_unused_layout_slides om alleen niet‑gerefereerde indelingen te verwijderen.

Presentatiedia's vergelijken in Python Diaformaat wijzigen in presentaties met Python