Správa tvarů v prezentacích pomocí Pythonu

Přehled

Tento průvodce představuje manipulaci s tvary v Aspose.Slides pro Python přes .NET. Naučte se praktické postupy pro vyhledávání tvarů (včetně podle alternativního textu), duplikaci, mazání nebo skrytí, změnu pořadí, zarovnání a převrácení, čtení ID a formátování řízeného rozvržením a export jednotlivých tvarů do SVG pomocí API Presentation a Shape.

Najít tvary na snímcích

PowerPoint rozpoznává tvary pouze podle interních ID. Přidejte jedinečný alternativní text cílovému tvaru v PowerPointu, poté otevřete prezentaci pomocí Aspose.Slides pro Python, projděte tvary snímku a vyberte ten, jehož alternativní text odpovídá. Metoda find_shape tento přístup implementuje a vrací odpovídající tvar.

import aspose.slides as slides

# Najde tvar na snímku podle jeho alternativního textu.
def find_shape(slide, alt_text):
    for slide_shape in slide.shapes:
        if slide_shape.alternative_text == alt_text:
            return slide_shape
    return None


# Vytvoří instanci třídy Presentation, která představuje soubor prezentace.
with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    # Najde tvar s alternativním textem "Shape1".
    shape = find_shape(slide, "Shape1")
    if shape is not None:
        print("Shape name:", shape.name)

Klonovat tvary

Chcete‑li klonovat tvary ze zdrojového snímku do nového snímku v Aspose.Slides, postupujte takto:

  1. Vytvořte Presentation ze zdrojového souboru.
  2. Získejte zdrojový snímek podle indexu a jeho kolekci tvarů.
  3. Načtěte prázdné rozvržení z master‑snímku.
  4. Přidejte prázdný snímek pomocí tohoto rozvržení a získejte jeho tvary.
  5. Naklonujte tvary do cílového snímku.
  6. Uložte prezentaci jako PPTX.

Následující ukázkový kód klonuje tvary z jednoho snímku do druhého.

import aspose.slides as slides

# Vytvoří instanci třídy Presentation.
with slides.Presentation("sample.pptx") as presentation:
    source_shapes = presentation.slides[0].shapes
    blank_layout = presentation.masters[0].layout_slides.get_by_type(slides.SlideLayoutType.BLANK)

    target_slide = presentation.slides.add_empty_slide(blank_layout)
    target_shapes = target_slide.shapes
	
    target_shapes.add_clone(source_shapes[1], 50, 150 + source_shapes[0].height)
    target_shapes.add_clone(source_shapes[2])
    target_shapes.insert_clone(0, source_shapes[0], 50, 150)

    # Uloží prezentaci na disk.
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Odstranit tvary

Aspose.Slides umožňuje odebrat libovolný tvar ze snímku. Například chcete‑li smazat tvar z prvního snímku podle jeho alternativního textu, postupujte takto:

  1. Vytvořte instanci Presentation a načtěte soubor.
  2. Získejte první snímek z kolekce snímků.
  3. Najděte tvar podle hodnoty alternativního textu.
  4. Odeberte tvar z kolekce tvarů snímku.
  5. Uložte prezentaci na disk ve formátu PPTX.
import aspose.slides as slides

# Najde tvar na snímku podle jeho alternativního textu.
def find_shape(slide, alt_text):
    for slide_shape in slide.shapes:
        if slide_shape.alternative_text == alt_text:
            return slide_shape
    return None


# Vytvoří instanci třídy Presentation, která představuje soubor prezentace.
with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    # Najde tvar s alternativním textem "User Defined".
    shape = find_shape(slide, "User Defined")
    # Odebere tvar.
    slide.shapes.remove(shape)
    # Uloží prezentaci na disk.
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Skrýt tvary

Aspose.Slides umožňuje skrýt libovolný tvar na snímku. Například chcete‑li skrýt tvar na prvním snímku podle jeho alternativního textu, postupujte takto:

  1. Vytvořte instanci Presentation a načtěte soubor.
  2. Získejte první snímek z kolekce snímků.
  3. Najděte tvar podle hodnoty alternativního textu.
  4. Skryjte tvar.
  5. Uložte prezentaci na disk ve formátu PPTX.
# Najde tvar na snímku podle jeho alternativního textu.
def find_shape(slide, alt_text):
    for slide_shape in slide.shapes:
        if slide_shape.alternative_text == alt_text:
            return slide_shape
    return None


# Vytvoří instanci třídy Presentation, která představuje soubor prezentace.
with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    # Najde tvar s alternativním textem "User Defined".
    shape = find_shape(slide, "User Defined")
    # Skryje tvar.
    shape.hidden = True
    # Uloží prezentaci na disk.
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Změnit pořadí tvarů

Aspose.Slides umožňuje vývojářům změnit pořadí tvarů (z‑order). Změna pořadí určuje, který tvar bude před ostatními a který za nimi. Například chcete‑li změnit pořadí dvou tvarů na prvním snímku, postupujte takto:

  1. Vytvořte instanci třídy Presentation.
  2. Získejte první snímek.
  3. Přidejte první tvar (např. obdélník).
  4. Přidejte druhý tvar (např. trojúhelník).
  5. Změňte pořadí tvarů přesunutím druhého tvaru na první pozici v kolekci.
  6. Uložte prezentaci na disk.
import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    # Přidá dva tvary na snímek.
    shape1 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 20, 20, 200, 150)
    shape2 = slide.shapes.add_auto_shape(slides.ShapeType.TRIANGLE, 20, 200, 200, 150)
    # Přesune druhý tvar na první pozici.
    slide.shapes.reorder(0, shape2)
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Získat Interop ID tvaru

Aspose.Slides umožňuje získat jedinečný identifikátor tvaru v rozsahu snímku, na rozdíl od vlastnosti unique_id, která je jedinečná v celé prezentaci. Vlastnost office_interop_shape_id je k dispozici ve třídě Shape. Její hodnota odpovídá Id objektu Microsoft.Office.Interop.PowerPoint.Shape. Níže je ukázkový fragment kódu.

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    # Získá jedinečný identifikátor tvaru v rámci snímku.
    officeInteropShapeId = presentation.slides[0].shapes[0].office_interop_shape_id

Nastavit alternativní text pro tvary

Aspose.Slides umožňuje vývojářům nastavit alternativní text pro libovolný tvar. Alternativní text můžete použít k identifikaci a vyhledávání tvarů v prezentaci. Vlastnost alternativního textu lze číst i zapisovat jak z Aspose.Slides, tak z Microsoft PowerPoint. Označením tvarů touto vlastností je můžete později odstranit, skrýt nebo změnit jejich pořadí na snímku.

Pro nastavení alternativního textu tvaru postupujte takto:

  1. Vytvořte instanci třídy Presentation.
  2. Získejte první snímek.
  3. Přidejte tvar na snímek.
  4. Nastavte alternativní text.
  5. Uložte prezentaci na disk.
import aspose.slides as slides

# Vytvoří instanci třídy Presentation, která představuje soubor PPTX.
with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    # Přidá tvar.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 40, 150, 50)
    # Nastaví alternativní text pro tvar.
    shape.alternative_text = "User Defined"
    # Uloží prezentaci na disk.
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Přístup k formátům rozvržení pro tvary

Aspose.Slides poskytuje jednoduché API pro přístup k formátům rozvržení tvarů. Tato část ukazuje, jak získat formáty rozvržení.

import aspose.slides as slides

with slides.Presentation(folder_path + "sample.pptx") as presentation:
    for layout_slide in presentation.layout_slides:
        fill_formats = list(map(lambda shape: shape.fill_format, layout_slide.shapes))
        line_formats = list(map(lambda shape: shape.line_format, layout_slide.shapes))

Vykreslit tvary jako SVG

Aspose.Slides podporuje vykreslování tvarů jako SVG. Metoda write_as_svg (a její přetížení) ve třídě Shape umožňuje uložit obsah tvaru jako SVG‑obrázek. Níže uvedený fragment kódu ukazuje, jak exportovat tvar do souboru SVG.

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    with open("output.svg", "wb") as image_stream:
        # Získá první tvar na prvním snímku.
        shape = presentation.slides[0].shapes[0]
        shape.write_as_svg(image_stream)

Zarovnat tvar

Pomocí metody align_shape ve třídě SlidesUtil můžete:

  • Zarovnávat tvary vzhledem k okrajům snímku (viz Příklad 1).
  • Zarovnávat tvary vzhledem k sobě navzájem (viz Příklad 2).

Výčtová hodnota ShapesAlignmentType definuje dostupné možnosti zarovnání.

Příklad 1

Tento Python‑kód ukazuje, jak zarovnat tvary s indexy 1, 2 a 4 k hornímu okraji snímku:

import aspose.slides as slides

align_type = slides.ShapesAlignmentType.ALIGN_TOP
slide_indices = [1, 2, 4]

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    slides.util.SlideUtil.align_shapes(align_type, True, slide, slide_indices)

Příklad 2

Tento Python‑příklad ukazuje, jak zarovnat všechny tvary v kolekci vzhledem k nejnižšímu tvaru v této kolekci:

import aspose.slides as slides

align_type = slides.ShapesAlignmentType.ALIGN_BOTTOM

with slides.Presentation("sample.pptx") as presentation:
    slides.util.SlideUtil.align_shapes(align_type, False, presentation.slides[0])

Vlastnosti překlápění

V Aspose.Slides třída ShapeFrame poskytuje ovládání horizontálního a vertikálního zrcadlení tvarů pomocí vlastností flip_h a flip_v. Obě vlastnosti jsou typu NullableBool a umožňují hodnoty TRUE (překlopit), FALSE (nepřeklopit) nebo NOT_DEFINED (použít výchozí chování). Tyto hodnoty jsou přístupné z tvaru Frame.

Chcete‑li upravit nastavení překlápění, vytvoří se nová instance ShapeFrame s aktuální pozicí a velikostí tvaru, požadovanými hodnotami flip_h a flip_v a úhlem otočení. Přiřazením této instance k tvaru Frame a uložením prezentace se aplikují zrcadlové transformace a zapíšou do výstupního souboru.

Předpokládejme, že máme soubor sample.pptx, ve kterém první snímek obsahuje jediný tvar s výchozím nastavením překlápění, jak je zobrazено níže.

The shape to be flipped

Následující ukázkový kód načte aktuální vlastnosti překlápění tvaru a přeloží jej horizontálně i vertikálně.

with slides.Presentation("sample.pptx") as presentation:
    shape = presentation.slides[0].shapes[0]

    # Získá horizontální vlastnost překlápění tvaru.
    horizontal_flip = shape.frame.flip_h
    print("Horizontal flip:", horizontal_flip)

    # Získá vertikální vlastnost překlápění tvaru.
    vertical_flip = shape.frame.flip_v
    print("Vertical flip:", vertical_flip)

    x, y = shape.frame.x, shape.frame.y
    width, height = shape.frame.width, shape.frame.height
    flip_h, flip_v = slides.NullableBool.TRUE, slides.NullableBool.TRUE  # Překlápí horizontálně i vertikálně.
    rotation = shape.frame.rotation

    shape.frame = slides.ShapeFrame(x, y, width, height, flip_h, flip_v, rotation)

    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Výsledek:

The flipped shape

Často kladené otázky

Mohu na snímku sloučit tvary (union/intersect/subtract) jako v desktopovém editoru?

Neexistuje vestavěné API pro booleovské operace. Můžete to napodobit vytvořením požadovaného obrysu sami — např. vypočítat výslednou geometrii (pomocí GeometryPath) a vytvořit nový tvar s touto konturou, volitelně odstranit původní tvary.

Jak mohu řídit pořadí vrstvení (z‑order), aby tvar vždy zůstal „nahoře“?

Změňte pořadí vložení/přesunu v kolekci shapes snímku. Pro předvídatelné výsledky definujte z‑order po všech ostatních úpravách snímku.

Mohu „uzamknout“ tvar, aby ho uživatelé nemohli v PowerPointu upravovat?

Ano. Nastavte ochranné příznaky na úrovni tvaru (např. zamknutí výběru, přesunu, změny velikosti, úpravy textu). V potřebě můžete tuto ochranu replikovat v masteru nebo rozvržení. Upozorňujeme, že jde o ochranu na úrovni uživatelského rozhraní, nikoli o bezpečnostní prvek; pro vyšší zabezpečení kombinujte s omezeními na úrovni souboru, např. doporučením jen pro čtení nebo hesly (read‑only recommendations or passwords).

Použít efekty tvarů v prezentacích s Pythonem Získání efektivních vlastností tvaru z prezentací v Pythonu