Placeringsmærke Aspose.Slides FOSS Python API-reference

A. Det er ikke muligt. placeringsmærke er et reserveret område på en layout eller master-skærm, der definerer: en standardposition, størrelse og formatering for en bestemt type indhold (tittel, Når en almindelig slide er baseret på et enkelt diagram, skal den være i overensstemmelse med de forskellige data. Layout, der har pladsholderer, de tilsvarende former på slides arve dem positioner og formater.

Package: aspose.slides_foss

Hvordan de der har plads i denne ordning arbejder

Placerholderne er internt repræsenteret som almindelige former, hvis XML bærer en <p:ph> element, der angiver placeringsholdertype og indeks. Shape klasse læses: <p:ph> at afgøre, om en form er et stedholder og går den layout → master arvskæde til at løse formets position, når der ikke er lokal <a:xfrm> er defineret.

Der er ingen standalone. Placeholder klassefil i denne udgave; pladsholder Identiteten er indeholdt i den underliggende værdi. AutoShape, Table,eller anden form.

Finder stedholderformer

En form på et layout eller XML-skærm er en pladsholder, når dens nvSpPr/nvPr (eller tilsvarende blok med ikke-visuelle egenskaber) indeholder en <p:ph> element. Det er et vigtigt punkt.

Den Europæiske Union Shape basisklasse udsætter den interne hjælper _get_placeholder_info() som er: returnerer en (ph_type, ph_idx) en eller flere gange None for former uden pladsholder.

Layout og Master-placeringsinddragelse

Når en skydespillet ikke har sin egen form <a:xfrm> Det er et vigtigt element i den fælles politik. opklarer position og størrelse fra den tilsvarende pladsholder i layout-sliden, og Så fra hovedskærmen, hvis layout ikke definerer en heller. Dette er et eksempel på at bruge denne metode til at få udført en oversigt af de forskellige typer billeder i den pågældende diagram. overlevering håndteres automatisk; kun klientkode får adgang til shape.x, shape.y, shape.width, og shape.height.

PlaceholderType (angivet i __all__)

Følgende placeringsholdertyper er erklæret i den offentlige API-overflade. De kortlægger til den type atribut af <p:ph> i OOXML:

Kodeksempler

Identificer placeringsform på et layout

import aspose.slides_foss as slides

with slides.Presentation("deck.pptx") as prs:
    layout = prs.layout_slides[0]
    print(f"Layout: {layout.name!r}")
    for shape in layout.shapes:
        # Access the internal placeholder info via the XML helper
        ph_info = shape._get_placeholder_info() if hasattr(shape, '_get_placeholder_info') else None
        if ph_info:
            ph_type, ph_idx = ph_info
            print(f"  Placeholder: type={ph_type!r}  idx={ph_idx}"
                  f"  at ({shape.x:.0f}, {shape.y:.0f})")
        else:
            print(f"  Regular shape: {shape.name!r}")

Tilføj et billede og arbejd med det i titlen.

import aspose.slides_foss as slides
from aspose.slides_foss import SlideLayoutType
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    # Use the Title layout which has a title placeholder
    title_layout = prs.layout_slides.get_by_type(SlideLayoutType.TITLE)
    if title_layout is None:
        title_layout = prs.layout_slides[0]

    slide = prs.slides.add_empty_slide(title_layout)

    # The first shape on a TITLE layout is typically the title placeholder
    for shape in slide.shapes:
        if hasattr(shape, 'add_text_frame'):
            shape.add_text_frame("Quarterly Review")
            break

    prs.save("titled-slide.pptx", SaveFormat.PPTX)

Tilføj tekst til alle former på en slide (herunder pladsholder)

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

with slides.Presentation("template.pptx") as prs:
    slide = prs.slides[0]
    for i, shape in enumerate(slide.shapes):
        if hasattr(shape, 'add_text_frame'):
            try:
                shape.add_text_frame(f"Content {i + 1}")
            except Exception:
                pass  # some shapes may not accept text
    prs.save("filled.pptx", SaveFormat.PPTX)

Se også:

• Reference til klasser af slide
• LayoutSlide / MasterSlide reference
• Reference til formklasse
• ShapeCollection reference
• Slides Python API Reference hjem