Formenmanipulationen

Form auf Folie finden

Dieses Thema beschreibt eine einfache Technik, die es Entwicklern erleichtert, eine bestimmte Form auf einer Folie zu finden, ohne deren interne ID zu verwenden. Es ist wichtig zu wissen, dass PowerPoint-Präsentationsdateien keine Möglichkeit haben, Formen auf einer Folie außer einer internen eindeutigen ID zu identifizieren. Es scheint für Entwickler schwierig zu sein, eine Form anhand ihrer internen eindeutigen ID zu finden. Alle auf die Folien hinzugefügten Formen haben einen Alt-Text. Wir schlagen vor, dass Entwickler alternativen Text verwenden, um eine bestimmte Form zu finden. Sie können MS PowerPoint verwenden, um den alternativen Text für Objekte festzulegen, die Sie in Zukunft ändern möchten.

Nachdem Sie den alternativen Text einer gewünschten Form festgelegt haben, können Sie diese Präsentation mit Aspose.Slides für Android über Java öffnen und durch alle auf eine Folie hinzugefügten Formen iterieren. Während jeder Iteration können Sie den alternativen Text der Form überprüfen, und die Form mit dem übereinstimmenden alternativen Text wäre die von Ihnen benötigte Form. Um diese Technik besser zu demonstrieren, haben wir eine Methode, findShape, erstellt, die den Trick macht, um eine bestimmte Form in einer Folie zu finden und dann einfach diese Form zurückzugeben.

// Instanziieren Sie eine Präsentationsklasse, die die Präsentationsdatei darstellt
Presentation pres = new Presentation("FindingShapeInSlide.pptx");
try {

    ISlide slide = pres.getSlides().get_Item(0);
    // Alternativer Text der zu findenden Form
    IShape shape = findShape(slide, "Shape1");
    if (shape != null)
    {
        System.out.println("Formname: " + shape.getName());
    }
} finally {
    if (pres != null) pres.dispose();
}

// Methodenimplementierung zur Suche einer Form in einer Folie mithilfe ihres alternativen Textes
public static IShape findShape(ISlide slide, String alttext)
{
    // Iteration durch alle Formen innerhalb der Folie
    for (int i = 0; i < slide.getShapes().size(); i++)
    {
        // Wenn der alternative Text der Folie mit dem benötigten übereinstimmt, dann
        // Geben Sie die Form zurück
        if (slide.getShapes().get_Item(i).getAlternativeText().compareTo(alttext) == 0)
            return slide.getShapes().get_Item(i);
    }
    return null;
}

Form klonen

Um eine Form auf eine Folie mit Aspose.Slides für Android über Java zu klonen:

  1. Erstellen Sie eine Instanz der Presentation Klasse.
  2. Erhalten Sie das Referenz einer Folie, indem Sie ihren Index verwenden.
  3. Greifen Sie auf die Quellen-Folienformensammlung zu.
  4. Fügen Sie eine neue Folie zur Präsentation hinzu.
  5. Klonen Sie Formen aus der Quellen-Folienformensammlung zur neuen Folie.
  6. Speichern Sie die modifizierte Präsentation als PPTX-Datei.

Das folgende Beispiel fügt eine Gruppenform zu einer Folie hinzu.

// Instanziieren Sie die Präsentationsklasse
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);

    // Schreiben Sie die PPTX-Datei auf die Festplatte
    pres.save("CloneShape_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Form entfernen

Aspose.Slides für Android über Java ermöglicht es Entwicklern, jede Form zu entfernen. Um die Form von einer Folie zu entfernen, befolgen Sie bitte die folgenden Schritte:

  1. Erstellen Sie eine Instanz der Presentation Klasse.
  2. Greifen Sie auf die erste Folie zu.
  3. Finden Sie die Form mit speziellem AlternativeText.
  4. Entfernen Sie die Form.
  5. Speichern Sie die Datei auf der Festplatte.
// Erstellen Sie ein Präsentationsobjekt
Presentation pres = new Presentation();
try {
    // Holen Sie sich die erste Folie
    ISlide sld = pres.getSlides().get_Item(0);

    // Fügen Sie eine Autoform vom Rechtecktyp hinzu
    sld.getShapes().addAutoShape(ShapeType.Rectangle, 50, 40, 150, 50);
    sld.getShapes().addAutoShape(ShapeType.Moon, 160, 40, 150, 50);

    String altText = "Benutzerdefiniert";
    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);
        }
    }

    // Speichern Sie die Präsentation auf der Festplatte
    pres.save("RemoveShape_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Form ausblenden

Aspose.Slides für Android über Java ermöglicht es Entwicklern, jede Form auszublenden. Um die Form von einer Folie auszublenden, befolgen Sie bitte die folgenden Schritte:

  1. Erstellen Sie eine Instanz der Presentation Klasse.
  2. Greifen Sie auf die erste Folie zu.
  3. Finden Sie die Form mit speziellem AlternativeText.
  4. Blenden Sie die Form aus.
  5. Speichern Sie die Datei auf der Festplatte.
// Instanziieren Sie die Präsentationsklasse, die die PPTX darstellt
Presentation pres = new Presentation();
try {
    // Holen Sie sich die erste Folie
    ISlide sld = pres.getSlides().get_Item(0);

    // Fügen Sie eine Autoform vom Rechtecktyp hinzu
    sld.getShapes().addAutoShape(ShapeType.Rectangle, 50, 40, 150, 50);
    sld.getShapes().addAutoShape(ShapeType.Moon, 160, 40, 150, 50);

    String alttext = "Benutzerdefiniert";
    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);
        }
    }

    // Speichern Sie die Präsentation auf der Festplatte
    pres.save("Hiding_Shapes_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Formenreihenfolge ändern

Aspose.Slides für Android über Java ermöglicht es Entwicklern, die Reihenfolge der Formen zu ändern. Die Neuanordnung der Formen gibt an, welche Form vorne oder hinten ist. Um die Form von einer Folie neu anzuordnen, befolgen Sie bitte die folgenden Schritte:

  1. Erstellen Sie eine Instanz der Presentation Klasse.
  2. Greifen Sie auf die erste Folie zu.
  3. Fügen Sie eine Form hinzu.
  4. Fügen Sie etwas Text in den Textrahmen der Form ein.
  5. Fügen Sie eine andere Form mit denselben Koordinaten hinzu.
  6. Ändern Sie die Reihenfolge der Formen.
  7. Speichern Sie die Datei auf der Festplatte.
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("Wasserzeichen Text Wasserzeichen Text Wasserzeichen 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();
}

Interop-Shape-ID erhalten

Aspose.Slides für Android über Java ermöglicht es Entwicklern, eine eindeutige Formen-ID im Folienkontext zu erhalten, im Gegensatz zur getUniqueId Methode, die die Beschaffung einer eindeutigen ID im Präsentationskontext ermöglicht. Die Methode getOfficeInteropShapeId wurde zu den IShape Schnittstellen und der Shape Klasse hinzugefügt. Der Wert, der von der Methode getOfficeInteropShapeId zurückgegeben wird, entspricht dem Wert der ID des Microsoft.Office.Interop.PowerPoint.Shape Objekts. Unten finden Sie einen Beispielcode.

Presentation pres = new Presentation("Presentation.pptx");
try {
    // Eindeutige Formen-ID im Folienkontext erhalten
    long officeInteropShapeId = pres.getSlides().get_Item(0).getShapes().get_Item(0).getOfficeInteropShapeId();

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

Alternativen Text für Form festlegen

Aspose.Slides für Android über Java ermöglicht es Entwicklern, den Alternativen Text jeder Form festzulegen. Formen in einer Präsentation können durch die AlternativeText oder Formname Methode unterschieden werden. Die Methoden setAlternativeText und getAlternativeText können sowohl mit Aspose.Slides als auch mit Microsoft PowerPoint gelesen oder festgelegt werden. Mit dieser Methode können Sie eine Form taggen und verschiedene Operationen wie das Entfernen einer Form, das Ausblenden einer Form oder das Neuanordnen von Formen auf einer Folie durchführen. Um den alternativen Text einer Form festzulegen, befolgen Sie bitte die folgenden Schritte:

  1. Erstellen Sie eine Instanz der Presentation Klasse.
  2. Greifen Sie auf die erste Folie zu.
  3. Fügen Sie eine beliebige Form zur Folie hinzu.
  4. Machen Sie einige Arbeiten mit der neu hinzugefügten Form.
  5. Durchlaufen Sie die Formen, um eine Form zu finden.
  6. Setzen Sie den Alternativen Text.
  7. Speichern Sie die Datei auf der Festplatte.
// Instanziieren Sie die Präsentationsklasse, die die PPTX darstellt
Presentation pres = new Presentation();
try {
    // Holen Sie sich die erste Folie
    ISlide sld = pres.getSlides().get_Item(0);

    // Fügen Sie eine Autoform vom Rechtecktyp hinzu
    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("Benutzerdefiniert");
        }
    }

    // Speichern Sie die Präsentation auf der Festplatte
    pres.save("Set_AlternativeText_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Layout-Formate für Formen zugreifen

Aspose.Slides für Android über Java bietet eine einfache API, um auf Layout-Formate für eine Form zuzugreifen. Dieser Artikel demonstriert, wie Sie auf Layout-Formate zugreifen können.

Unten ist ein Beispielcode gegeben.

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

Formen als SVG rendern

Jetzt unterstützt Aspose.Slides für Android über Java das Rendern einer Form als SVG. Die Methode writeAsSvg (und ihre Überladungen) wurde zur Shape Klasse und zur IShape Schnittstelle hinzugefügt. Diese Methode ermöglicht es, den Inhalt der Form als SVG-Datei zu speichern. Der untenstehende Codeausschnitt zeigt, wie man die Form einer Folie in eine SVG-Datei exportiert.

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

Formen-Ausrichtung

Aspose.Slides ermöglicht es, Formen entweder relativ zu den Folienrändern oder relativ zueinander auszurichten. Zu diesem Zweck wurde die überladene Methode SlidesUtil.alignShape() hinzugefügt. Die Enumeration ShapesAlignmentType definiert mögliche Ausrichtungsoptionen.

Beispiel 1

Der Quellcode unten richtet Formen mit den Indizes 1, 2 und 4 entlang der oberen Kante der Folie aus.

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

Beispiel 2

Das folgende Beispiel zeigt, wie man die gesamte Sammlung von Formen relativ zur untersten Form in der Sammlung ausrichtet.

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