A helyfoglaló Aspose.Slides FOSS Python API hivatkozás

A. Az alábbiak: helyfogadó egy elrendezés vagy a fő dia fenntartott régiója, amely meghatározza az alábbiakat: az adott tartalomtípus alapértelmezett elhelyezkedése, mérete és formázása (cím, Ha egy normál dia a következők alapján készül, az adott elemet kell használni: a távirat megfelelő alakjai örökölni azokat, hogy az előzetes. pozíciók és formátumok.

Paket: aspose.slides_foss

Hogyan dolgoznak a helyfoglalók ebben az alkalmazásban?

A helyfoglalók belsőleg olyan szokásos formákként jelennek meg, amelyek XML-ben a <p:ph> A helyfoglaló típusát és indexét meghatározó elem. Shape osztály olvasható: <p:ph> hogy meghatározza, ha egy alak helyfoglaló és jár a layout → master öröklés lánc a forma pozíciójának megoldására, ha nincs helyi <a:xfrm> meghatározva van.

Nincs egy önálló. Placeholder osztályfájl ebben a kiadásban; helyfoglaló az azonosító a mögöttes értékpapíron keresztül kerül átadásra. AutoShape, Table, vagy más formában.

A helyfogó formák felismerése

Egy alak egy XML-szillaton vagy layoutban helyfoglaló, amikor a formája az XML. nvSpPr/nvPr (vagy egyenértékű nem vizuális tulajdonságok blokk) tartalmazza a <p:ph> elem.

A Bizottság Shape A bázisosztály felfedi a belső segítőket. _get_placeholder_info() amely: az a-t adja vissza. (ph_type, ph_idx) a szög vagy None a helyfogó nélküli alakzatok esetében.

A felépítés és a fő helyfoglaló öröklés

Ha egy diaforma nem saját <a:xfrm> elem, a keretrendszer a felületet és méretet az összehasonlító helyfoglalóból a táblázatban határozza meg, valamint A programot a következőkben kell megfejteni: az öröklés automatikusan történik; a kliens kód csak hozzáférhet shape.x, shape.y, shape.width,és a következők: shape.height.

PlaceholderType (az Európai Unió Hivatalos Lapjában bejelentett) __all__)

A következő helyfoglaló típusokat a nyilvános API-felületben deklarálják. a Bizottsághoz. type a tulajdonságok <p:ph> OOXML:

Kód példákat

A felület helyfogó formáinak azonosítása

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}")

Töltsön egy dialapírt és dolgozzon a cím helyfoglalóval!

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)

A szöveget a képernyő összes formájához (beleértve az helyfogókat is) hozzáadni

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)

Lásd még:

• Számítógép osztály referencia
• LayoutSlide / MasterSlide hivatkozás
• Formaosztály hivatkozása
• ShapeCollection hivatkozás
• Slide Python API Referencia-helye