Správa zástupných prvků v prezentaci na Androidu

Přehled

Zástupný prvek je tvar, který vyhrazuje pozici pro určitý typ obsahu v šabloně prezentace. Běžnými příklady jsou zástupné prvky pro nadpis, tělo, obrázek, graf a obecně určený obsah. Na rozdíl od běžného tvaru může zástupný prvek dědit svou pozici, velikost, formátování a další nastavení z rozložení snímku nebo hlavního snímku.

Aspose.Slides zpřístupňuje informace o zástupných prvcích prostřednictvím metody IShape.getPlaceholder. Metoda vrací objekt IPlaceholder nebo null pro běžný tvar. Použijte IPlaceholder.getType pro určení, co má zástupný prvek obsahovat.

Rozhraní tvaru i nadále platí poté, co znáte typ zástupného prvku:

  • Prázdný textový, obrázkový, grafový nebo obsahový zástupný prvek je obvykle reprezentován pomocí IAutoShape.
  • Vyplněný obrázkový zástupný prvek může být reprezentován pomocí IPictureFrame.
  • Vyplněný grafový zástupný prvek může být reprezentován pomocí IChart.
  • Obsahový zástupný prvek může obsahovat několik typů obsahu. Zkontrolujte jak IPlaceholder.getType tak rozhraní tvaru za běhu, místo abyste předpokládali, že každý zástupný prvek je IAutoShape.

Pochopení dědičnosti zástupných prvků

Zástupné prvky tvoří hierarchii:

  1. Hlavní snímek definuje znovupoužitelné styly a v některých případech zástupné prvky na úrovni hlavního snímku.
  2. Rozložení snímku definuje uspořádání používané jedním nebo více běžnými snímky a může dědit z hlavního snímku.
  3. Běžný snímek obsahuje zástupné prvky pro tento snímek a může dědit ze svého rozložení.

Volejte IShape.getBasePlaceholder pro posun o jednu úroveň výše v této hierarchii. Zástupný prvek snímku obvykle vrací svůj zástupný prvek rozložení; zástupný prvek rozložení může vrátit svůj hlavní zástupný prvek. Metoda vrací null, když tvar nemá základní zástupný prvek.

Následující příklad vypisuje zástupné prvky na prvním snímku a uvádí jejich základní zástupné prvky:

import com.aspose.slides.*;

Presentation presentation = new Presentation("template.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    for (IShape shape : slide.getShapes()) {
        IPlaceholder placeholder = shape.getPlaceholder();
        if (placeholder == null) {
            continue;
        }

        byte placeholderType = placeholder.getType();
        String typeName = shape.getClass().getSimpleName();
        String slidePlaceholderMessage = "Slide placeholder: " + placeholderType + "; shape interface: " + typeName;
        System.out.println(slidePlaceholderMessage);

        IShape layoutPlaceholder = shape.getBasePlaceholder();
        if (layoutPlaceholder != null) {
            IPlaceholder layoutPlaceholderInfo = layoutPlaceholder.getPlaceholder();
            Byte layoutPlaceholderType = layoutPlaceholderInfo == null ? null : layoutPlaceholderInfo.getType();
            String layoutPlaceholderMessage = "  Layout placeholder: " + layoutPlaceholderType;
            System.out.println(layoutPlaceholderMessage);

            IShape masterPlaceholder = layoutPlaceholder.getBasePlaceholder();
            if (masterPlaceholder != null) {
                IPlaceholder masterPlaceholderInfo = masterPlaceholder.getPlaceholder();
                Byte masterPlaceholderType = masterPlaceholderInfo == null ? null : masterPlaceholderInfo.getType();
                String masterPlaceholderMessage = "  Master placeholder: " + masterPlaceholderType;
                System.out.println(masterPlaceholderMessage);
            }
        }
    }
} finally {
    presentation.dispose();
}

Upravení zástupného prvku na běžném snímku vytvoří nebo změní lokální přepsání pro tento snímek. Úprava souvisejícího rozložení nebo hlavního snímku může ovlivnit všechny snímky, které stále toto nastavení dědí. Lokální běžný tvar nemá základní zástupný prvek a nezačne dědit jen proto, že zabírá stejné souřadnice.

Odstranění stavu zástupného prvku

Po úpravě šablony použijte IShape.removePlaceholder pro zachování existujícího objektu jako běžného tvaru. Jeho getPlaceholder metoda vrací null, ale tvar zůstává ve sbírce snímku. Naopak IShapeCollection.remove odstraní tvar z této sbírky.

Následující příklad vyžaduje template.pptx s alespoň jedním snímkem a neprázdným textovým zástupným prvkem na prvním snímku. Použijte zástupný prvek s formátováním děděným z jeho rozložení nebo hlavního snímku, abyste viděli efekt odstranění tohoto vztahu. Příklad kontroluje, že stejný tvar zůstává, znovu volá metodu na nyní běžném tvaru a uloží výsledek.

import com.aspose.slides.*;

Presentation presentation = new Presentation("template.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    boolean found = false;

    for (int index = 0; index < slide.getShapes().size(); index++) {
        IShape candidate = slide.getShapes().get_Item(index);
        if (!(candidate instanceof IAutoShape)) {
            continue;
        }

        IAutoShape shape = (IAutoShape) candidate;
        ITextFrame textFrame = shape.getTextFrame();
        if (shape.getPlaceholder() == null ||
            textFrame == null ||
            textFrame.getText() == null ||
            textFrame.getText().isEmpty()) {
            continue;
        }

        int shapeCount = slide.getShapes().size();
        shape.removePlaceholder();

        System.out.println("Placeholder removed: " + (shape.getPlaceholder() == null));
        System.out.println("Same shape retained: " + (slide.getShapes().get_Item(index) == shape));
        System.out.println("Shape count unchanged: " + (slide.getShapes().size() == shapeCount));

        // Volání metody na běžném tvaru nemá žádný efekt.
        shape.removePlaceholder();
        found = true;
        break;
    }

    if (found) {
        presentation.save("placeholder-status-removed.pptx", SaveFormat.Pptx);
    } else {
        System.out.println("No nonempty text placeholder was found on the first slide.");
    }
} finally {
    presentation.dispose();
}

Pro odpovídající zástupný prvek všechny tři kontroly vypíší true. Text zůstává, ale děděná pozice, velikost, rotace, písmo, zarovnání odstavce, okraje textového rámce, svislé ukotvení, výplň a nastavení čáry se mohou po odstranění vztahu zástupného prvku změnit. Například děděné formátování nadpisu může přejít na běžné formátování textu. Viz Rozvržení snímku pro více informací o rozloženích.

Aby bylo zachováno zamýšlené vzhled, zachyťte vypočtenou pozici, velikost a rotaci před voláním a zkopírujte požadované hodnoty efektivního formátování do samostatných proměnných. Získejte tyto hodnoty pomocí IPortionFormat.getEffective, IParagraphFormat.getEffective, ITextFrameFormat.getEffective, IFillFormat.getEffective, a ILineFormat.getEffective. Nespoléhejte se jen na uchování objektů efektivního formátování, protože jejich hodnoty textového formátování se mohou po odstranění vztahu změnit. Výslovně aplikujte zachycené hodnoty na běžný tvar po té, včetně rodiny písma, velikosti, stylu, barvy, nastavení odstavce, nastavení textového rámce, výplně a čáry používané ve vaší šabloně.

Děděná geometrie tvaru může také vyžadovat explicitní přiřazení pomocí IGeometryShape.setShapeType. Pro obdélníkový textový zástupný prvek to znamená přiřadit ShapeType.Rectangle; obnovení pouze výplně a čáry nemusí obnovit viditelný obdélník. Šablony s dalšími efekty nebo složitějším formátováním také vyžadují, aby tato nastavení byla ošetřena.

Změna textu v zástupném prvku

Nadpisové, středové nadpisové, podnadpisové, tělové a textové zástupné prvky normálně podporují text. Zkontrolujte IAutoShape před použitím jeho metody getTextFrame.

Následující příklad aktualizuje první zástupný prvek nadpisu na prvním snímku a uloží výsledek:

import com.aspose.slides.*;

Presentation presentation = new Presentation("template.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IAutoShape titleShape = null;

    for (IShape shape : slide.getShapes()) {
        if (!(shape instanceof IAutoShape)) {
            continue;
        }

        IAutoShape autoShape = (IAutoShape) shape;
        IPlaceholder placeholder = autoShape.getPlaceholder();
        if (placeholder == null) {
            continue;
        }

        byte placeholderType = placeholder.getType();
        if (placeholderType == PlaceholderType.Title || placeholderType == PlaceholderType.CenteredTitle) {
            titleShape = autoShape;
            break;
        }
    }

    if (titleShape == null) {
        throw new IllegalStateException("The first slide does not contain a title placeholder.");
    }

    titleShape.getTextFrame().setText("Quarterly Business Review");
    presentation.save("title-placeholder-updated.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Tento vzor se vyhýbá přetypování obrázkových, grafových, tabulkových nebo mediálních zástupných prvků na IAutoShape. Také identifikuje zástupný prvek podle účelu místo spoléhaní se na křehký index tvaru.

Nastavení textu výzvy v rozložení

Text výzvy je návrhový pokyn zobrazovaný v prázdném zástupném prvku, například Klikněte pro přidání nadpisu. Nastavte vlastní text výzvy na zástupném prvku rozložení místo pokusu o jeho získání přes sbírku tvarů běžného snímku. Přístup k rozložení získáte pomocí ISlide.getLayoutSlide a iterujte přes sbírku vrácenou metodou ILayoutSlide.getShapes.

Následující příklad mění výzvy nadpisu a podnadpisu v rozložení použitém prvním snímkem:

import com.aspose.slides.*;

Presentation presentation = new Presentation("template.pptx");
try {
    ILayoutSlide layoutSlide = presentation.getSlides().get_Item(0).getLayoutSlide();

    for (IShape shape : layoutSlide.getShapes()) {
        if (!(shape instanceof IAutoShape)) {
            continue;
        }

        IAutoShape autoShape = (IAutoShape) shape;
        IPlaceholder placeholder = autoShape.getPlaceholder();
        if (placeholder == null) {
            continue;
        }

        byte placeholderType = placeholder.getType();

        if (placeholderType == PlaceholderType.Title || placeholderType == PlaceholderType.CenteredTitle) {
            autoShape.getTextFrame().setText("Enter a concise slide title");
        } else if (placeholderType == PlaceholderType.Subtitle) {
            autoShape.getTextFrame().setText("Enter a subtitle or reporting period");
        }
    }

    presentation.save("custom-placeholder-prompts.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Text výzvy není běžný obsah snímku. Je určen pro prázdné zástupné prvky v editačních aplikacích, jako je PowerPoint. Jakmile uživatel nebo program poskytne skutečný obsah, výzva se již nezobrazuje. Změna výzvy také nenahrazuje existující text na snímcích, které používají toto rozložení.

Aktualizace obrázkového zástupného prvku

Existují dva případy, které je třeba ošetřit:

Následující příklad podporuje oba případy a uloží prezentaci:

import com.aspose.slides.*;
import java.io.FileInputStream;

Presentation presentation = new Presentation("picture-template.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IShape picturePlaceholder = null;

    for (IShape shape : slide.getShapes()) {
        IPlaceholder placeholder = shape.getPlaceholder();
        if (placeholder != null && placeholder.getType() == PlaceholderType.Picture) {
            picturePlaceholder = shape;
            break;
        }
    }

    if (picturePlaceholder == null) {
        throw new IllegalStateException("The first slide does not contain a picture placeholder.");
    }

    IPPImage image;
    try (FileInputStream imageStream = new FileInputStream("replacement.png")) {
        image = presentation.getImages().addImage(imageStream);
    }

    if (picturePlaceholder instanceof IPictureFrame) {
        IPictureFrame pictureFrame = (IPictureFrame) picturePlaceholder;
        pictureFrame.getPictureFormat().getPicture().setImage(image);
    } else {
        slide.getShapes().addPictureFrame(ShapeType.Rectangle, picturePlaceholder.getX(), picturePlaceholder.getY(), picturePlaceholder.getWidth(), picturePlaceholder.getHeight(), image);
        slide.getShapes().remove(picturePlaceholder);
    }

    presentation.save("picture-placeholder-updated.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Náhrada vytvořená pro prázdný zástupný prvek je lokální obrázkový rám, nikoli nový zástupný prvek, protože IShape.getPlaceholder nenabízí setter. Zachovává vyhrazenou pozici, ale již nedědí chování specifické pro zástupné prvky. Pokud je zachování vztahu zástupného prvku podstatné, nejprve připravte a vyplňte zástupný prvek v PowerPointu, pak aktualizujte výsledný IPictureFrame pomocí Aspose.Slides.

Pro průhlednost obrázku, ořezávání a další efekty specifické pro obrázek viz Spravovat obrázkové rámy. Tyto operace patří k obrázkovému rámci nebo výplni obrázku, nikoli k metadatům zástupného prvku.

Práce s grafovými a obsahovými zástupnými prvky

Vyplněný grafový zástupný prvek může být reprezentován pomocí IChart. Tento příklad najde takový graf jak podle typu zástupného prvku, tak rozhraní za běhu, změní jeho nadpis a uloží soubor:

import com.aspose.slides.*;

Presentation presentation = new Presentation("chart-template.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IChart placeholderChart = null;

    for (IShape shape : slide.getShapes()) {
        if (!(shape instanceof IChart)) {
            continue;
        }

        IChart chart = (IChart) shape;
        IPlaceholder placeholder = chart.getPlaceholder();
        if (placeholder != null && placeholder.getType() == PlaceholderType.Chart) {
            placeholderChart = chart;
            break;
        }
    }

    if (placeholderChart == null) {
        throw new IllegalStateException("The first slide does not contain a populated chart placeholder.");
    }

    placeholderChart.setTitle(true);
    placeholderChart.getChartTitle().addTextFrameForOverriding("Quarterly Revenue");
    presentation.save("chart-placeholder-updated.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Obecný obsahový zástupný prvek má obvykle PlaceholderType.Object. V PowerPointu funguje jako spouštěč pro několik typů obsahu, včetně grafů, tabulek, diagramů, obrázků a médií. Po jeho vyplnění zkontrolujte skutečné rozhraní tvaru, abyste zjistili, co obsahuje. Specializovaná rozložení mohou také odhalovat PlaceholderType.Chart, PlaceholderType.Table, PlaceholderType.Picture, PlaceholderType.Media, nebo PlaceholderType.Diagram.

Aspose.Slides nepřevádí prázdný IAutoShape zástupný prvek na IChart pouhým změněním IPlaceholder.getType; typ nelze změnit prostřednictvím rozhraní. Pro naplnění prázdného grafu nebo obsahové oblasti programově přidejte požadovaný objekt na souřadnice zástupného prvku a poté odstraňte prázdný zástupný prvek. Následující příklad to provádí pro graf:

import com.aspose.slides.*;

Presentation presentation = new Presentation("content-template.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IShape targetPlaceholder = null;

    for (IShape shape : slide.getShapes()) {
        IPlaceholder placeholder = shape.getPlaceholder();
        if (placeholder == null) {
            continue;
        }

        byte placeholderType = placeholder.getType();
        if (placeholderType == PlaceholderType.Chart || placeholderType == PlaceholderType.Object) {
            targetPlaceholder = shape;
            break;
        }
    }

    if (targetPlaceholder == null) {
        throw new IllegalStateException("The first slide does not contain a chart or content placeholder.");
    }

    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, targetPlaceholder.getX(), targetPlaceholder.getY(), targetPlaceholder.getWidth(), targetPlaceholder.getHeight());
    chart.setTitle(true);
    chart.getChartTitle().addTextFrameForOverriding("Quarterly Revenue");
    slide.getShapes().remove(targetPlaceholder);
    presentation.save("content-placeholder-replaced-with-chart.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Přidaný graf je běžný lokální graf. Zabírá oblast zástupného prvku, ale nedědí z rozložení zástupného prvku. Použijte věnované články o správě grafů když potřebujete nahradit jeho kategorie, řady nebo data sešitu.

Kompletní příklad: Aktualizace textového nebo obrazového obsahu

Následující kompletní příklad otevře šablonu, prohledá první snímek pro zástupný prvek nadpisu nebo obrázku, zkontroluje typy zástupného prvku a tvaru, aktualizuje odpovídající obsah a uloží výstup. Příklad úmyslně se vyhýbá předpokladu indexu tvaru nebo přetypování každého zástupného prvku na stejné rozhraní.

import com.aspose.slides.*;
import java.io.FileInputStream;

Presentation presentation = new Presentation("template.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    boolean updated = false;

    for (IShape shape : slide.getShapes()) {
        IPlaceholder placeholder = shape.getPlaceholder();
        if (placeholder == null) {
            continue;
        }

        byte placeholderType = placeholder.getType();

        if ((placeholderType == PlaceholderType.Title || placeholderType == PlaceholderType.CenteredTitle) && shape instanceof IAutoShape) {
            IAutoShape titleShape = (IAutoShape) shape;
            titleShape.getTextFrame().setText("Quarterly Business Review");
            updated = true;
            break;
        }

        if (placeholderType == PlaceholderType.Picture) {
            IPPImage image;
            try (FileInputStream imageStream = new FileInputStream("replacement.png")) {
                image = presentation.getImages().addImage(imageStream);
            }

            if (shape instanceof IPictureFrame) {
                IPictureFrame pictureFrame = (IPictureFrame) shape;
                pictureFrame.getPictureFormat().getPicture().setImage(image);
            } else {
                slide.getShapes().addPictureFrame(ShapeType.Rectangle, shape.getX(), shape.getY(), shape.getWidth(), shape.getHeight(), image);
                slide.getShapes().remove(shape);
            }

            updated = true;
            break;
        }
    }

    if (!updated) {
        throw new IllegalStateException("No supported title or picture placeholder was found on the first slide.");
    }

    presentation.save("placeholder-content-updated.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Často kladené otázky

Co je základní zástupný prvek?

Základní zástupný prvek je odpovídající tvar na rozložení nebo hlavním snímku, ze kterého další zástupný prvek dědí. Použijte IShape.getBasePlaceholder pro jeho získání. Běžný lokální tvar vrací null, protože není součástí hierarchie zástupných prvků.

Mohu změnit všechny nadpisy snímků úpravou zástupného prvku rozložení?

Můžete změnit děděné formátování nebo text výzvy pomocí rozložení, ale existující obsah nadpisu je uložen na běžných snímcích. Pro nahrazení skutečného textu nadpisu v celé prezentaci iterujte přes snímky a aktualizujte každý zástupný prvek nadpisu.

Jak spravovat zástupné prvky data, čísla snímku, hlavičky a patičky?

Použijte správce hlaviček a patiček v příslušném rozsahu snímku, rozložení, hlavního snímku, poznámek nebo rozdělaných listů. Viz Manage Presentation Header and Footer pro kompletní příklady.