Beheer presentatievormen in Java

Overzicht

Dit artikel legt uit hoe u met vormen in presentaties kunt werken met Aspose.Slides. Het laat zien hoe u een vorm op een dia kunt vinden, klonen, verwijderen, verbergen, de volgorde kunt wijzigen, de Interop‑vorm‑ID kunt ophalen en alternatieve tekst kunt instellen voor identificatie en verdere verwerking.

Het behandelt ook hoe u lay‑outformaten voor vormen kunt benaderen, een vorm kunt renderen als SVG, vormen op een dia kunt uitlijnen en flip‑eigenschappen voor horizontaal en verticaal spiegelen kunt gebruiken. Bovendien bevat het artikel een korte FAQ over het combineren van vormen, stapelvolgorde en het vergrendelen van vormen.

Zoek een vorm op een dia

Dit onderwerp beschrijft een eenvoudige techniek om het voor ontwikkelaars gemakkelijker te maken een specifieke vorm op een dia te vinden zonder de interne Id te gebruiken. Het is belangrijk te weten dat PowerPoint‑presentatiebestanden geen andere manier hebben om vormen op een dia te identificeren dan een interne unieke Id. Het is vaak lastig voor ontwikkelaars om een vorm te vinden via die interne unieke Id. Alle toegevoegde vormen hebben enige alternatieve tekst. Wij raden ontwikkelaars aan alternatieve tekst te gebruiken om een specifieke vorm te vinden. U kunt in MS PowerPoint de alternatieve tekst definiëren voor objecten die u later wilt wijzigen.

Na het instellen van de alternatieve tekst van de gewenste vorm kunt u de presentatie openen met Aspose.Slides for Java en alle vormen op een dia doorlopen. Tijdens elke iteratie controleert u de alternatieve tekst; de vorm met de overeenkomende alternatieve tekst is de door u gewenste vorm. Om deze techniek beter te demonstreren hebben we een methode, findShape gemaakt die een specifieke vorm in een dia vindt en vervolgens die vorm retourneert.

// Instantieer een Presentation‑klasse die het presentatiebestand vertegenwoordigt
Presentation pres = new Presentation("FindingShapeInSlide.pptx");
try {

    ISlide slide = pres.getSlides().get_Item(0);
    // Alternatieve tekst van de vorm die moet worden gevonden
    IShape shape = findShape(slide, "Shape1");
    if (shape != null)
    {
        System.out.println("Shape Name: " + shape.getName());
    }
} finally {
    if (pres != null) pres.dispose();
}

// Methode-implementatie om een vorm op een dia te vinden via de alternatieve tekst
public static IShape findShape(ISlide slide, String alttext)
{
    // Itereren door alle vormen op de dia
    for (int i = 0; i < slide.getShapes().size(); i++)
    {
        // Als de alternatieve tekst van de vorm overeenkomt met de gevraagde, dan
        // Retourneer de vorm
        if (slide.getShapes().get_Item(i).getAlternativeText().compareTo(alttext) == 0)
            return slide.getShapes().get_Item(i);
    }
    return null;
}

Kloon een vorm

Om een vorm te klonen naar een dia met Aspose.Slides for Java:

  1. Maak een instantie van de Presentation‑klasse.
  2. Haal de referentie van een dia op via de index.
  3. Benader de vormcollectie van de bron‑dia.
  4. Voeg een nieuwe dia toe aan de presentatie.
  5. Kloon vormen van de bron‑dia‑vormcollectie naar de nieuwe dia.
  6. Sla de aangepaste presentatie op als een PPTX‑bestand.

Het voorbeeld hieronder voegt een groepsvorm toe aan een dia.

// Instantieer Presentation‑klasse
Presentation pres = new Presentation("Source Frame.pptx");
try {
    IShapeCollection sourceShapes = pres.getSlides().get_Item(0).getShapes();
    ILayoutSlide blankLayout = pres.getMasters().get_Item(0).getLayoutSlides().getByType(SlideLayoutType.Blank);
    ISlide destSlide = pres.getSlides().addEmptySlide(blankLayout);
    IShapeCollection destShapes = destSlide.getShapes();
    destShapes.addClone(sourceShapes.get_Item(1), 50, 150 + sourceShapes.get_Item(0).getHeight());
    destShapes.addClone(sourceShapes.get_Item(2));
    destShapes.insertClone(0, sourceShapes.get_Item(0), 50, 150);

    // Schrijf het PPTX‑bestand naar schijf
    pres.save("CloneShape_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Verwijder een vorm

Aspose.Slides for Java stelt ontwikkelaars in staat elke vorm te verwijderen. Volg de onderstaande stappen om de vorm van een dia te verwijderen:

  1. Maak een instantie van de Presentation‑klasse.
  2. Open de eerste dia.
  3. Zoek de vorm met specifieke AlternativeText.
  4. Verwijder de vorm.
  5. Sla het bestand op schijf.
// Maak Presentation-object aan
Presentation pres = new Presentation();
try {
    // Haal de eerste dia op
    ISlide sld = pres.getSlides().get_Item(0);

    // Voeg autoshape van type rechthoek toe
    sld.getShapes().addAutoShape(ShapeType.Rectangle, 50, 40, 150, 50);
    sld.getShapes().addAutoShape(ShapeType.Moon, 160, 40, 150, 50);

    String altText = "User Defined";
    int iCount = sld.getShapes().size();
    for (int i = 0; i < iCount; i++)
    {
        AutoShape ashp = (AutoShape)sld.getShapes().get_Item(0);
        if (alttext.equals(ashp.getAlternativeText()))
        {
            sld.getShapes().remove(ashp);
        }
    }

    // Sla de presentatie op schijf
    pres.save("RemoveShape_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Verberg een vorm

Aspose.Slides for Java stelt ontwikkelaars in staat elke vorm te verbergen. Volg de onderstaande stappen om de vorm van een dia te verbergen:

  1. Maak een instantie van de Presentation‑klasse.
  2. Open de eerste dia.
  3. Zoek de vorm met specifieke AlternativeText.
  4. Verberg de vorm.
  5. Sla het bestand op schijf.
// Instantieer Presentation‑klasse die de PPTX vertegenwoordigt
Presentation pres = new Presentation();
try {
    // Haal de eerste dia op
    ISlide sld = pres.getSlides().get_Item(0);

    // Voeg autoshape van type rechthoek toe
    sld.getShapes().addAutoShape(ShapeType.Rectangle, 50, 40, 150, 50);
    sld.getShapes().addAutoShape(ShapeType.Moon, 160, 40, 150, 50);

    String alttext = "User Defined";
    int iCount = sld.getShapes().size();
    for (int i = 0; i < iCount; i++)
    {
        AutoShape ashp = (AutoShape)sld.getShapes().get_Item(i);
        if (alttext.equals(ashp.getAlternativeText()))
        {
            ashp.setHidden(true);
        }
    }

    // Sla de presentatie op schijf
    pres.save("Hiding_Shapes_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Wijzig volgorde van een vorm

Aspose.Slides for Java stelt ontwikkelaars in staat vormen opnieuw te rangschikken. Het herschikken van een vorm bepaalt welke vorm voorop staat en welke achterop. Volg de onderstaande stappen om de volgorde van een vorm op een dia aan te passen:

  1. Maak een instantie van de Presentation‑klasse.
  2. Open de eerste dia.
  3. Voeg een vorm toe.
  4. Voeg tekst toe in het tekstframe van de vorm.
  5. Voeg een tweede vorm toe met dezelfde coördinaten.
  6. Rangschik de vormen.
  7. Sla het bestand op schijf.
Presentation pres = new Presentation("ChangeShapeOrder.pptx");
try {
    ISlide slide = pres.getSlides().get_Item(0);
    IAutoShape shp3 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 365, 400, 150);
    shp3.getFillFormat().setFillType(FillType.NoFill);
    shp3.addTextFrame(" ");

    IParagraph para = shp3.getTextFrame().getParagraphs().get_Item(0);
    IPortion portion = para.getPortions().get_Item(0);
    portion.setText("Watermark Text Watermark Text Watermark Text");

    shp3 = slide.getShapes().addAutoShape(ShapeType.Triangle, 200, 365, 400, 150);

    slide.getShapes().reorder(2, shp3);

    pres.save("Reshape_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Haal de Interop‑vorm‑ID op

Aspose.Slides for Java stelt ontwikkelaars in staat een unieke vorm‑identificator binnen de dia‑scope op te halen, in tegenstelling tot de getUniqueId‑methode die een unieke identifier op presentatieniveau biedt. De methode getOfficeInteropShapeId is toegevoegd aan de IShape‑interface en de Shape‑klasse. De waarde die door getOfficeInteropShapeId wordt geretourneerd, correspondeert met de Id‑waarde van het Microsoft.Office.Interop.PowerPoint.Shape‑object. Hieronder staat een voorbeeldcode.

Presentation pres = new Presentation("Presentation.pptx");
try {
    // Unieke vormidentificator ophalen binnen de dia-scope
    long officeInteropShapeId = pres.getSlides().get_Item(0).getShapes().get_Item(0).getOfficeInteropShapeId();

} finally {
    if (pres != null) pres.dispose();
}

Stel alternatieve tekst in voor een vorm

Aspose.Slides for Java stelt ontwikkelaars in staat de AlternateText van elke vorm in te stellen. Vormen in een presentatie kunnen worden onderscheiden via de AlternativeText of Shape Name‑methode. De methoden setAlternativeText en getAlternativeText kunnen zowel met Aspose.Slides als met Microsoft PowerPoint gelezen of ingesteld worden. Met deze methode kunt u een vorm labelen en verschillende bewerkingen uitvoeren, zoals een vorm verwijderen, verbergen of rangschikken op een dia. Volg de onderstaande stappen om de AlternateText van een vorm in te stellen:

  1. Maak een instantie van de Presentation‑klasse.
  2. Open de eerste dia.
  3. Voeg een willekeurige vorm toe aan de dia.
  4. Voer bewerkingen uit met de nieuw toegevoegde vorm.
  5. Doorloop de vormen om een specifieke vorm te vinden.
  6. Stel de AlternativeText in.
  7. Sla het bestand op schijf.
// Instantieer Presentation‑klasse die de PPTX vertegenwoordigt
Presentation pres = new Presentation();
try {
    // Haal de eerste dia op
    ISlide sld = pres.getSlides().get_Item(0);

    // Voeg autoshape van type rechthoek toe
    IShape shp1 = sld.getShapes().addAutoShape(ShapeType.Rectangle, 50, 40, 150, 50);
    IShape shp2 = sld.getShapes().addAutoShape(ShapeType.Moon, 160, 40, 150, 50);
    shp2.getFillFormat().setFillType(FillType.Solid);
    shp2.getFillFormat().getSolidFillColor().setColor(Color.GRAY);

    for (int i = 0; i < sld.getShapes().size(); i++)
    {
        AutoShape shape = (AutoShape) sld.getShapes().get_Item(i);
        if (shape != null)
        {
            shape.setAlternativeText("User Defined");
        }
    }

    // Sla de presentatie op schijf
    pres.save("Set_AlternativeText_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Benader lay‑outformaten voor een vorm

Aspose.Slides for Java biedt een eenvoudige API om lay‑outformaten voor een vorm te benaderen. Dit artikel demonstreert hoe u de lay‑outformaten kunt benaderen.

Hieronder staat voorbeeldcode.

Presentation pres = new Presentation("pres.pptx");
try {
    for (ILayoutSlide layoutSlide : pres.getLayoutSlides())
    {
        for (IShape shape : layoutSlide.getShapes())
        {
            IFillFormat fillFormats = shape.getFillFormat();
            ILineFormat lineFormats = shape.getLineFormat();
        }
    }
} finally {
    if (pres != null) pres.dispose();
}

Render een vorm als SVG

Aspose.Slides for Java ondersteunt nu het renderen van een vorm als SVG. De methode writeAsSvg (en een overload) is toegevoegd aan de Shape‑klasse en de IShape‑interface. Deze methode maakt het mogelijk de inhoud van de vorm op te slaan als een SVG‑bestand. De onderstaande code‑fragment toont hoe u de vorm van een dia exporteert naar een SVG‑bestand.

Presentation pres = new Presentation("TestExportShapeToSvg.pptx");
try {
    FileOutputStream stream = new FileOutputStream("SingleShape.svg");
    try {
        pres.getSlides().get_Item(0).getShapes().get_Item(0).writeAsSvg(stream);
    } finally {
        if (stream != null) stream.close();
    }
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Lijn een vorm uit

Aspose.Slides maakt het mogelijk vormen uit te lijnen ten opzichte van de dia‑randen of ten opzichte van elkaar. Hiervoor is de overladen methode SlidesUtil.alignShape() toegevoegd. De enumeratie ShapesAlignmentType definieert de mogelijke uitlijnopties.

Voorbeeld 1

De broncode hieronder lineert de vormen met index 1, 2 en 4 langs de bovenrand van de dia.

Presentation pres = new Presentation("example.pptx");
try {
    ISlide slide = pres.getSlides().get_Item(0);
    IShape shape1 = slide.getShapes().get_Item(1);
    IShape shape2 = slide.getShapes().get_Item(2);
    IShape shape3 = slide.getShapes().get_Item(4);
    SlideUtil.alignShapes(ShapesAlignmentType.AlignTop, true, pres.getSlides().get_Item(0), new int[]
    {
        slide.getShapes().indexOf(shape1),
        slide.getShapes().indexOf(shape2),
        slide.getShapes().indexOf(shape3)
    });
} finally {
    if (pres != null) pres.dispose();
}
}

Voorbeeld 2

Het voorbeeld hieronder laat zien hoe u de volledige collectie vormen uitlijnt ten opzichte van de onderste vorm in de collectie.

Presentation pres = new Presentation("example.pptx");
try {
    SlideUtil.alignShapes(ShapesAlignmentType.AlignBottom, false, pres.getSlides().get_Item(0));
} finally {
    if (pres != null) pres.dispose();
}

Flip‑eigenschappen

In Aspose.Slides biedt de ShapeFrame‑klasse controle over horizontaal en verticaal spiegelen van vormen via de eigenschappen flipH en flipV. Beide eigenschappen zijn van type byte en kunnen de waarden 1 (spiegelen), 0 (niet spiegelen) of -1 (standaardgedrag) aannemen. Deze waarden zijn toegankelijk via het Frame van een vorm.

Om de flip‑instellingen te wijzigen, wordt een nieuw ShapeFrame‑object gecreëerd met de huidige positie en afmeting van de vorm, de gewenste waarden voor flipH en flipV en de rotatiehoek. Door dit object toe te wijzen aan het Frame van de vorm en de presentatie op te slaan, worden de spiegeltransformaties toegepast en vastgelegd in het uitvoerbestand.

Stel dat we een bestand sample.pptx hebben waarin de eerste dia een enkele vorm bevat met standaard flip‑instellingen, zoals hieronder weergegeven.

The shape to be flipped

De volgende code‑voorbeeld haalt de huidige flip‑eigenschappen van de vorm op en spiegelt deze zowel horizontaal als verticaal.

Presentation presentation = new Presentation("sample.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IShape shape = slide.getShapes().get_Item(0);

    // Haal de horizontale flip‑eigenschap van de vorm op.
    byte horizontalFlip = shape.getFrame().getFlipH();
    System.out.println("Horizontal flip: " + horizontalFlip);

    // Haal de verticale flip‑eigenschap van de vorm op.
    byte verticalFlip = shape.getFrame().getFlipV();
    System.out.println("Vertical flip: " + verticalFlip);

    float x = shape.getFrame().getX();
    float y = shape.getFrame().getY();
    float width = shape.getFrame().getWidth();
    float height = shape.getFrame().getHeight();
    byte flipH = NullableBool.True; // Flip horizontally.
    byte flipV = NullableBool.True; // Flip horizontally.
    float rotation = shape.getFrame().getRotation();

    shape.setFrame(new ShapeFrame(x, y, width, height, flipH, flipV, rotation));

    presentation.save("output.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Het resultaat:

The flipped shape

FAQ

Kan ik vormen (union/intersect/subtract) op een dia combineren zoals in een desktop‑editor?

Er is geen ingebouwde Boolean‑operatie‑API. U kunt een benadering maken door zelf de gewenste omtrek te construeren – bijvoorbeeld de resulterende geometrie berekenen (via GeometryPath) en een nieuwe vorm met die contour maken, eventueel de originele vormen verwijderen.

Hoe kan ik de stapelvolgorde (z‑order) regelen zodat een vorm altijd "bovenop" blijft?

Wijzig de invoeg‑/verplaatsvolgorde binnen de shapes‑collectie van de dia. Voor voorspelbare resultaten finaliseert u de z‑order nadat alle andere dia‑wijzigingen zijn uitgevoerd.

Kan ik een vorm "vergrendelen" zodat gebruikers deze niet kunnen bewerken in PowerPoint?

Ja. Stel de shape‑level protection flags in (bijv. vergrendel selectie, verplaatsing, grootte wijzigen, tekstbewerking). Indien nodig kunt u vergelijkbare beperkingen op de master‑ of lay‑out instellen. Let op: dit is bescherming op UI‑niveau, geen beveiligingsfunctie; voor sterkere bescherming combineert u dit met bestands‑niveau restricties zoals read‑only aanbevelingen of wachtwoorden.

Toepassen van vormeffecten in presentaties met Java Effectieve vormeigenschappen ophalen uit presentaties in Java