Beheer slide‑masters van presentaties in Python

Waar deze pagina over gaat

Beheer slide‑masters in Aspose.Slides voor Python via .NET: toegang, bewerking, kloon, vergelijking en verwijdering van master‑dia’s in PowerPoint- en OpenDocument‑presentaties.

Overzicht

Een slide master definieert gedeelde ontwerpinstellingen voor een groep dia’s. Het kan gemeenschappelijke vormen, logo’s, achtergronden, tekstopmaak, themainstellingen en voettekstinstellingen bevatten. In PowerPoint is het bewerken van een slide master de gebruikelijke manier om een presentatie consistent te houden zonder dezelfde opmaak op elke dia te herhalen.

Aspose.Slides for Python via .NET ondersteunt hetzelfde model. Een presentatie kan één of meer masterdia’s bevatten, en elke masterdia kan meerdere lay-outdia’s bevatten. Normale dia’s verwijzen meestal niet direct naar een masterdia. In plaats daarvan gebruikt een normale dia een lay-outdia, en die lay-outdia behoort tot een masterdia.

De hiërarchie is:

Slide master – definieert het gedeelde ontwerp en thema.
Layout slide – definieert een specifieke rangschikking van placeholders en opmaak op lay‑outniveau.
Normal slide – bevat de feitelijke presentatie‑inhoud en gebruikt één lay‑outdia.

De hiërarchie van masterdia’s, lay‑outdia’s en normale dia’s

In Aspose.Slides wordt een slide master weergegeven door de MasterSlide klasse. Alle masterdia’s in een presentatie zijn beschikbaar via de Presentation.masters collectie.

Inheritance

Wanneer dezelfde eigenschap op meer dan één niveau is gedefinieerd, wint het specifiekere niveau. Bijvoorbeeld, als een masterdia en een lay‑outdia beide een achtergrond definiëren, gebruiken dia’s die op die lay‑out zijn gebaseerd de lay‑outachtergrond. Voor meer informatie over lay‑outdia’s, zie Apply or Change Slide Layouts.

Toegang tot slide masters

In PowerPoint kun je de Slide Master‑weergave openen via View > Slide Master.

De Slide Master‑opdracht op het tabblad View in PowerPoint

In Aspose.Slides gebruik je de masters collectie om masterdia’s te benaderen:

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    first_master_slide = presentation.masters[0]
    master_slide_count = len(presentation.masters)
    first_master_layout_slide_count = len(first_master_slide.layout_slides)

    print("Master slides: " + str(master_slide_count))
    print("Layouts in the first master: " + str(first_master_layout_slide_count))

Je kunt ook de masterdia ophalen die door een normale dia wordt gebruikt via zijn lay‑out:

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    slide = presentation.slides[0]
    layout_slide = slide.layout_slide
    master_slide = layout_slide.master_slide
    master_slide_name = master_slide.name

    print(master_slide_name)

Wat een slide master bevat

Een masterdia is een dia‑achtig object. Het erft algemeen dia‑gedrag van de BaseSlide klasse, zodat het veel van dezelfde dia‑eigenschappen beschikbaar maakt die door normale en lay‑outdia’s worden gebruikt. Master‑specifieke leden staan opgesomd op de MasterSlide API‑pagina.

Veelgebruikte leden van een masterdia zijn onder andere:

Lid	Doel
`background`	Stelt de slide‑achtergrond op master‑niveau in.
`shapes`	Slaat vormen op die op de master zijn geplaatst, zoals logo’s, afbeeldingskaders en gedeelde tekst.
`layout_slides`	Bevat de lay‑outdia’s die bij de master horen.
`theme_manager`	Biedt toegang tot de master‑thema‑API’s.
`header_footer_manager`	Beheert kop‑ en voetteksten, datums en dia‑nummers voor de master en haar onderliggende lay‑outs.
`get_depending_slides`	Retourneert normale dia’s die via hun lay‑outs afhankelijk zijn van de master.

Afbeelding toevoegen aan een slide master

Wanneer je een afbeelding toevoegt aan een masterdia, verschijnt deze op dia’s die lay‑-outs van die master gebruiken. Dit is handig voor logo’s, watermerken, decoratieve banden en andere herhalende visuele elementen.

Het volgende voorbeeld voegt een logo toe aan de eerste masterdia:

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    master_slide = presentation.masters[0]

    with open("logo.png", "rb") as logo_stream:
        logo_bytes = logo_stream.read()

    logo_image = presentation.images.add_image(logo_bytes)

    master_slide.shapes.add_picture_frame(
        slides.ShapeType.RECTANGLE,
        20,
        20,
        80,
        80,
        logo_image)

    presentation.save("presentation-with-logo.pptx", slides.export.SaveFormat.PPTX)

Voor meer informatie over afbeeldingskaders, zie Afbeeldingskader.

De zichtbaarheid van master‑graphics regelen

Gebruik BaseSlide.show_master_shapes om geërfde master‑graphics, zoals logo’s of decoratieve vormen, te verbergen zonder ze uit de master te verwijderen. Zet Slide.show_master_shapes op False op de dia die die graphics moet weglaten en laat het op True staan op dia’s die ze wel moeten weergeven.

Het volgende zelfstandige voorbeeld maakt een blauwe decoratieve band op een master en twee dia’s die dezelfde lege lay‑out gebruiken. De band is zichtbaar op de eerste dia en verborgen op de tweede. Er is geen invoerpresentatie of afbeelding nodig.

import aspose.pydrawing as draw
import aspose.slides as slides

with slides.Presentation() as presentation:
    master_slide = presentation.masters[0]
    layout_slide = master_slide.layout_slides.get_by_type(slides.SlideLayoutType.BLANK)
    layout_slide.show_master_shapes = True

    slide_height = presentation.slide_size.size.height
    band = master_slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 0, 0, 60, slide_height)
    band.fill_format.fill_type = slides.FillType.SOLID
    band.fill_format.solid_fill_color.color = draw.Color.steel_blue
    band.line_format.fill_format.fill_type = slides.FillType.NO_FILL

    visible_slide = presentation.slides[0]
    visible_slide.layout_slide = layout_slide
    visible_slide.shapes.clear()

    hidden_slide = presentation.slides.add_empty_slide(layout_slide)

    visible_slide.show_master_shapes = True
    hidden_slide.show_master_shapes = False

    presentation.save("master-graphics.pptx", slides.export.SaveFormat.PPTX)

Het voorbeeld gebruikt de Blank lay‑out die bij een nieuwe presentatie wordt geleverd en verwijdert de eigen placeholders van de eerste dia.

Kies de reikwijdte van de instelling

Een normale dia gebruikt zijn master via Slide.layout_slide en LayoutSlide.master_slide. Het instellen van de eigenschap op een individuele dia beïnvloedt alleen die dia. Het instellen van LayoutSlide.show_master_shapes op False verbergt master‑graphics voor dia’s die die gedeelde lay‑out gebruiken, zelfs als hun eigen instelling True is. Om graphics alleen op één dia te verbergen, wijzig je de eigenschap van die dia en laat je de gedeelde lay‑out ongewijzigd.

De instelling wordt niet ondersteund als zichtbaarheid‑controle op de masterdia zelf. Op een master geeft het altijd False terug, en het toewijzen van True veroorzaakt een uitzondering. Pas het toe op een normale dia of een lay‑out.

Grafische elementen onderscheiden van de achtergrond

Operatie	Effect
Master‑graphics verbergen	Regelt de zichtbaarheid van geërfde master‑vormen zonder ze te verwijderen of de eigen vormen van de dia te wijzigen.
De dia‑achtergrondvulling wijzigen	Wijzigt de achtergrondkleur, -gradient of -afbeelding. Master‑graphics zijn afzonderlijke vormen en kunnen zichtbaar blijven boven die achtergrond. Zie Presentation Background.
Een vorm van de master verwijderen	Verwijdert de gedeelde bronvorm, zodat deze niet meer beschikbaar is voor dia’s die die master gebruiken.

Werken met placeholders

Placeholders worden normaal gedefinieerd op lay‑outdia’s. De masterdia levert de gedeelde stijl en het thema die die lay‑outs overerven, terwijl elke lay‑out bepaalt welke placeholders beschikbaar zijn en waar ze worden geplaatst.

In PowerPoint zijn placeholder‑opdrachten beschikbaar in de Slide Master‑weergave.

De Insert Placeholder‑opdracht in de Slide Master‑weergave van PowerPoint

Om nieuwe placeholders toe te voegen met Aspose.Slides, werk je met de lay‑outdia die bij de master hoort:

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    master_slide = presentation.masters[0]
    blank_layout_slide = master_slide.layout_slides.get_by_type(slides.SlideLayoutType.BLANK)

    if blank_layout_slide is None:
        blank_layout_slide = presentation.layout_slides.add(
            master_slide,
            slides.SlideLayoutType.BLANK,
            "Blank")

    blank_layout_slide.placeholder_manager.add_text_placeholder(60, 120, 600, 80)

    presentation.slides.add_empty_slide(blank_layout_slide)
    presentation.save("presentation-with-placeholder.pptx", slides.export.SaveFormat.PPTX)

Je kunt ook placeholder‑vormen die al op een masterdia bestaan opmaken. Het volgende voorbeeld vindt de titel‑placeholder en past een lineaire gradient‑vulling toe:

import aspose.pydrawing as draw
import aspose.slides as slides


def find_placeholder(master_slide, placeholder_type):
    for shape in master_slide.shapes:
        if isinstance(shape, slides.AutoShape) and shape.placeholder is not None:
            if shape.placeholder.type == placeholder_type:
                return shape

    return None


with slides.Presentation("presentation.pptx") as presentation:
    master_slide = presentation.masters[0]
    title_placeholder = find_placeholder(master_slide, slides.PlaceholderType.TITLE)

    if title_placeholder is not None:
        red_gradient_color = draw.Color.from_argb(255, 0, 0)
        purple_gradient_color = draw.Color.from_argb(128, 0, 128)

        title_placeholder.fill_format.fill_type = slides.FillType.GRADIENT
        title_placeholder.fill_format.gradient_format.gradient_shape = slides.GradientShape.LINEAR
        title_placeholder.fill_format.gradient_format.gradient_stops.add(0, red_gradient_color)
        title_placeholder.fill_format.gradient_format.gradient_stops.add(1, purple_gradient_color)

    presentation.save("presentation-title-style.pptx", slides.export.SaveFormat.PPTX)

Opgemaakte titel‑placeholder geërfd door normale dia’s

Voor meer opties voor placeholder‑ en tekstopmaak, zie Set Prompt Text in Placeholder en Text Formatting.

Achtergrond van een slide master wijzigen

Een master‑achtergrond wordt geërfd door lay‑-outs en dia’s die deze niet overschrijven. Het volgende voorbeeld stelt een effen achtergrondkleur in voor de eerste masterdia:

import aspose.pydrawing as draw
import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    master_slide = presentation.masters[0]

    master_slide.background.type = slides.BackgroundType.OWN_BACKGROUND
    master_slide.background.fill_format.fill_type = slides.FillType.SOLID
    master_slide.background.fill_format.solid_fill_color.color = draw.Color.forest_green

    presentation.save("presentation-master-background.pptx", slides.export.SaveFormat.PPTX)

Voor gerelateerde onderwerpen, zie Presentation Background en Presentation Theme.

Een slide master klonen naar een andere presentatie

Gebruik de add_clone‑methode op de MasterSlideCollection klasse om een masterdia te kopiëren naar een andere presentatie. De gekopieerde master kan vervolgens door lay‑-outs en dia’s in de bestemmingspresentatie worden gebruikt.

import aspose.slides as slides

with slides.Presentation("source.pptx") as source_presentation:
    with slides.Presentation("destination.pptx") as destination_presentation:
        source_master_slide = source_presentation.masters[0]
        cloned_master_slide = destination_presentation.masters.add_clone(source_master_slide)

        destination_presentation.save("destination-with-master.pptx", slides.export.SaveFormat.PPTX)

Als je normale dia’s moet klonen samen met hun master, zie Clone Slides.

Meerdere slide masters toevoegen

Een presentatie kan meerdere masterdia’s bevatten. Dit is handig wanneer verschillende secties verschillende huisstijl, paginastuctuur of themainstellingen nodig hebben.

PowerPoint‑opdrachten voor het invoegen en beheren van masterdia’s

Het volgende voorbeeld kloont de standaard‑master, geeft de kloon een andere achtergrond, haalt een lege lay‑out onder die gekloonde master op en voegt een nieuwe dia toe gebaseerd op die lay‑out:

import aspose.pydrawing as draw
import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    default_master_slide = presentation.masters[0]
    section_master_slide = presentation.masters.add_clone(default_master_slide)

    section_master_slide.background.type = slides.BackgroundType.OWN_BACKGROUND
    section_master_slide.background.fill_format.fill_type = slides.FillType.SOLID
    section_master_slide.background.fill_format.solid_fill_color.color = draw.Color.light_steel_blue

    section_blank_layout = section_master_slide.layout_slides.get_by_type(slides.SlideLayoutType.BLANK)

    if section_blank_layout is None:
        section_blank_layout = presentation.layout_slides.add(
            section_master_slide,
            slides.SlideLayoutType.BLANK,
            "Section Blank")

    presentation.slides.add_empty_slide(section_blank_layout)
    presentation.save("presentation-with-multiple-masters.pptx", slides.export.SaveFormat.PPTX)

Slide masters vergelijken

Masterdia’s kunnen met de equals‑methode, geërfd van de BaseSlide klasse, worden vergeleken. De vergelijking controleert structuur en statische inhoud, zoals vormen, tekst, opmaak, animaties en andere dia‑instellingen. Het vergelijkt geen unieke identifiers, zoals dia‑ID’s, of dynamische placeholder‑waarden, zoals de huidige datum.

import aspose.slides as slides

with slides.Presentation("first.pptx") as first_presentation:
    with slides.Presentation("second.pptx") as second_presentation:
        first_presentation_master_count = len(first_presentation.masters)
        second_presentation_master_count = len(second_presentation.masters)

        for first_master_index in range(first_presentation_master_count):
            for second_master_index in range(second_presentation_master_count):
                first_master_slide = first_presentation.masters[first_master_index]
                second_master_slide = second_presentation.masters[second_master_index]
                are_master_slides_equal = first_master_slide.equals(second_master_slide)

                if are_master_slides_equal:
                    print(
                        "first.pptx master #{} equals second.pptx master #{}".format(
                            first_master_index,
                            second_master_index))

Voor meer informatie, zie Compare Presentation Slides.

Slide Master‑weergave instellen als standaard weergave

Gebruik de last_view‑eigenschap op de presentatie‑ViewProperties om de weergave te bepalen die PowerPoint eerst opent. Het volgende voorbeeld opent de presentatie in de Slide Master‑weergave:

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    presentation.view_properties.last_view = slides.ViewType.SLIDE_MASTER_VIEW
    presentation.save("presentation-master-view.pptx", slides.export.SaveFormat.PPTX)

Voor meer weergave‑instellingen, zie Save Presentation.

Ongebruikte masterdia’s verwijderen

Presentaties kunnen soms masterdia’s bevatten die niet langer door normale dia’s worden gebruikt. Het verwijderen van ongebruikte masters kan de bestandsgrootte verkleinen en het onderhoud van sjablonen vereenvoudigen.

Gebruik remove_unused om ongebruikte masters uit de masters collectie te verwijderen:

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    presentation.masters.remove_unused(True)
    presentation.save("presentation-clean.pptx", slides.export.SaveFormat.PPTX)

Je kunt ook de low‑code remove_unused_master_slides‑methode van de Compress klasse gebruiken:

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    slides.lowcode.Compress.remove_unused_master_slides(presentation)
    presentation.save("presentation-clean.pptx", slides.export.SaveFormat.PPTX)

FAQ

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

Een slide master definieert gedeelde ontwerpinstellingen zoals thema, achtergrond, gemeenschappelijke vormen en tekstopmaak. Een layout slide behoort tot een master slide en definieert een specifieke rangschikking van placeholders. Een normale dia gebruikt een layout slide, dus hij erft zowel van de lay‑out als van de master.

Kan één presentatie meerdere slide masters bevatten?

Ja. Een presentatie kan meerdere slide masters bevatten. Gebruik meerdere masters wanneer verschillende secties verschillende visuele systemen of huisstijlen nodig hebben.

Moet ik placeholders toevoegen aan een master slide of een layout slide?

In de meeste gevallen voeg je placeholders toe aan layout slides. Plaats gedeelde visuele elementen en gedeelde opmaak op de master slide, en plaats content‑placeholders op de lay‑outs die normale dia’s zullen gebruiken.

Kan ik een master slide verwijderen die nog wordt gebruikt?

Nee. Een master slide die afhankelijke dia’s heeft, kan niet veilig direct worden verwijderd. Verplaats eerst die dia’s naar lay‑-outs onder een andere master, of gebruik een opruimmethode voor ongebruikte masters die alleen masters verwijdert die niet in gebruik zijn.

Diaformaat wijzigen in presentaties met Python Beheer teken‑gidsen in presentaties in Python