Beheer presentatie-placeholders op Android

Waar deze pagina over gaat

Leer hoe je tekst-, afbeelding-, diagram- en inhoudsplaceholders kunt inspecteren en bewerken, en hoe placeholder-erfenis werkt met Aspose.Slides voor Android via Java.

Overzicht

Een placeholder is een vorm die een positie reserveert voor een bepaald type inhoud in een presentatiesjabloon. Veelvoorkomende voorbeelden zijn titel, tekstvak, afbeelding, diagram en algemene inhouds-placeholder. In tegenstelling tot een gewone vorm kan een placeholder zijn positie, grootte, opmaak en andere instellingen overnemen van een layout-slide of master-slide.

Aspose.Slides maakt placeholder-informatie beschikbaar via de IShape.getPlaceholder methode. De methode retourneert een IPlaceholder object of null voor een normale vorm. Gebruik IPlaceholder.getType om te bepalen welke inhoud de placeholder moet bevatten.

De vorm-interface blijft relevant nadat je het placeholder-type kent:

Een lege tekst-, afbeelding-, diagram- of inhouds-placeholder wordt doorgaans weergegeven door een IAutoShape.
Een gevulde afbeelding-placeholder kan worden weergegeven door een IPictureFrame.
Een gevulde diagram-placeholder kan worden weergegeven door een IChart.
Een inhouds-placeholder kan verschillende soorten inhoud bevatten. Controleer zowel IPlaceholder.getType als de runtime-vorm-interface in plaats van aan te nemen dat elke placeholder een IAutoShape is.

Warning

IPlaceholder.getType beschrijft de rol van een placeholder; het garandeert niet het runtime-type van de vorm. Gebruik altijd een type-check voordat je toegang krijgt tot tekst-, afbeelding-, diagram-, tabel- of mediagerichte leden.

Begrijp placeholder-erfenis

Placeholders vormen een hiërarchie:

Een master-slide definieert herbruikbare stijlen en, in sommige gevallen, master-niveau placeholders.
Een layout-slide bepaalt de indeling die door een of meer normale slides wordt gebruikt en kan overerven van de master.
Een normale slide bevat de placeholders voor die slide en kan overerven van de layout.

Roep IShape.getBasePlaceholder aan om één niveau hoger in deze hiërarchie te gaan. Een slide-placeholder retourneert doorgaans zijn layout-placeholder; een layout-placeholder kan zijn master-placeholder retourneren. De methode retourneert null wanneer de vorm geen basis-placeholder heeft.

Het volgende voorbeeld toont de placeholders op de eerste slide en rapporteert hun basis-placeholders:

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();
}

Het bewerken van een placeholder op een normale slide creëert of wijzigt een lokale overschrijving voor die slide. Het bewerken van de bijbehorende layout of master kan alle slides beïnvloeden die die instelling nog overerven. Een lokale gewone vorm heeft geen basis-placeholder en begint niet met overerven alleen omdat hij dezelfde coördinaten bezet.

Tekst wijzigen in een placeholder

Titel-, gecentreerde-titel-, ondertitel-, tekst- en inhouds-placeholders ondersteunen doorgaans tekst. Controleer op IAutoShape voordat je de getTextFrame methode gebruikt.

Dit voorbeeld werkt de eerste titel-placeholder op de eerste slide bij en slaat het resultaat op:

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();
}

Dit patroon vermijdt het casten van afbeelding-, diagram-, tabel- of media-placeholders naar IAutoShape. Het identificeert de placeholder ook op basis van het doel in plaats van te vertrouwen op een fragiele vorm-index.

Prompt-tekst instellen op een layout

Prompt-tekst is de ontwerpinstructie die wordt weergegeven in een lege placeholder, bijvoorbeeld Klik om een titel toe te voegen. Stel aangepaste prompt-tekst in op de layout-placeholder in plaats van te proberen deze via de vorm-collectie van een normale slide te benaderen. Toegang tot de layout krijg je via ISlide.getLayoutSlide en je kunt itereren over de collectie die wordt geretourneerd door ILayoutSlide.getShapes.

Het volgende voorbeeld wijzigt de titel- en ondertitel-prompts op de layout die door de eerste slide wordt gebruikt:

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();
}

Prompt-tekst is geen normale slide-inhoud. Het is bedoeld voor lege placeholders in bewerkingsapplicaties zoals PowerPoint. Zodra een gebruiker of programma echte inhoud levert, wordt de prompt niet meer weergegeven. Het wijzigen van een prompt vervangt ook niet de bestaande tekst op slides die de layout gebruiken.

Een afbeelding-placeholder bijwerken

Er zijn twee gevallen om af te handelen:

Als de afbeelding-placeholder al is gevuld en wordt weergegeven door een IPictureFrame, vervang je de afbeelding via IPictureFillFormat.getPicture en ISlidesPicture.setImage.
Als het nog een lege placeholder is, voeg je een afbeelding-frame toe op de coördinaten van de placeholder met IShapeCollection.addPictureFrame en verwijder je de lege placeholder.

Het volgende voorbeeld ondersteunt beide gevallen en slaat de presentatie op:

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();
}

De vervanging die voor een lege placeholder wordt gecreëerd is een lokaal afbeelding-frame, geen nieuwe placeholder, omdat IShape.getPlaceholder geen setter biedt. Het behoudt de gereserveerde positie maar erft geen placeholder-specifiek gedrag meer. Als het behouden van de placeholder-relatie essentieel is, maak en vul de placeholder eerst in PowerPoint aan, en werk daarna het resulterende IPictureFrame bij met Aspose.Slides.

Voor transparantie, bijsnijden en andere afbeelding-specifieke effecten, zie Manage Picture Frames. Die bewerkingen behoren tot het afbeelding-frame of de afbeelding-vulling, niet tot de placeholder-metadata.

Werken met diagram- en inhouds-placeholders

Een gevulde diagram-placeholder kan worden weergegeven door een IChart. Dit voorbeeld vindt zo’n diagram zowel op basis van placeholder-type als runtime-interface, wijzigt de titel en slaat het bestand op:

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();
}

Een algemene inhouds-placeholder heeft meestal PlaceholderType.Object. In PowerPoint fungeert het als een lanceerder voor verschillende inhoudstypen, waaronder diagrammen, tabellen, diagrammen, afbeeldingen en media. Nadat het is gevuld, inspecteer je de daadwerkelijke vorm-interface om te ontdekken wat het bevat. Gespecialiseerde layouts kunnen ook PlaceholderType.Chart, PlaceholderType.Table, PlaceholderType.Picture, PlaceholderType.Media, of PlaceholderType.Diagram blootleggen.

Aspose.Slides converteert geen lege IAutoShape placeholder naar een IChart alleen door IPlaceholder.getType te wijzigen; het type kan niet via de interface worden veranderd. Om een leeg diagram- of inhoudsgebied programmatically te vullen, voeg je het benodigde object toe op de coördinaten van de placeholder en verwijder je vervolgens de lege placeholder. Het volgende voorbeeld doet dit voor een diagram:

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();
}

Het toegevoegde diagram is een gewone lokale diagram. Het neemt het gebied van de placeholder in, maar erft niet van de layout-placeholder. Gebruik de speciale chart management articles wanneer je de categorieën, series of werkboek-gegevens moet vervangen.

Volledig voorbeeld: tekst of afbeelding-inhoud bijwerken

Het volgende end-to-end voorbeeld opent een sjabloon, zoekt de eerste slide naar een titel- of afbeelding-placeholder, controleert de placeholder- en vormtypen, werkt de juiste inhoud bij en slaat de uitvoer op. Het voorbeeld vermijdt bewust het aannemen van een vorm-index of het casten van elke placeholder naar dezelfde interface.

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();
}

FAQ

Wat is een basis-placeholder?

Een basis-placeholder is de overeenkomstige vorm op de layout of master waaruit een andere placeholder erft. Gebruik IShape.getBasePlaceholder om deze op te halen. Een gewone lokale vorm retourneert null omdat deze geen deel uitmaakt van de placeholder-hiërarchie.

Kan ik alle slide-titels wijzigen door een layout-placeholder te bewerken?

Je kunt geërfde opmaak of prompt-tekst via een layout wijzigen, maar bestaande titel-inhoud wordt opgeslagen op de normale slides. Om de daadwerkelijke titeltekst in een hele presentatie te vervangen, itereren over de slides en elke titel-placeholder bijwerken.

Hoe beheer ik datum-, slide-nummer-, header- en footer-placeholders?

Gebruik de header- en footer-managers op de juiste slide, layout, master, notities of handout-niveau. Zie Manage Presentation Header and Footer voor volledige voorbeelden.

Beheer tekstvakken in presentaties op Android