Gruppenformen in Präsentationen mit .NET

Eine Gruppenform hinzufügen

Aspose.Slides unterstützt die Arbeit mit Gruppenformen auf Folien. Diese Funktion hilft Entwicklern, reichhaltigere Präsentationen zu erstellen. Aspose.Slides für .NET unterstützt das Hinzufügen oder den Zugriff auf Gruppenformen. Es ist möglich, Formen zu einer hinzugefügten Gruppenform hinzuzufügen, um sie zu befüllen, oder auf irgendeine Eigenschaft der Gruppenform zuzugreifen. So fügen Sie einer Folie mit Aspose.Slides für .NET eine Gruppenform hinzu:

1. Erstellen Sie eine Instanz der Klasse Presentation.
2. Rufen Sie die Referenz einer Folie über deren Index ab.
3. Fügen Sie der Folie eine Gruppenform hinzu.
4. Fügen Sie die Formen zur hinzugefügten Gruppenform hinzu.
5. Speichern Sie die geänderte Präsentation als PPTX-Datei.

Das nachstehende Beispiel fügt einer Folie eine Gruppenform hinzu.

// Instanziieren der Presentation-Klasse 
using (Presentation pres = new Presentation())
{
    // Erste Folie abrufen 
    ISlide sld = pres.Slides[0];

    // Zugriff auf die Formensammlung der Folien 
    IShapeCollection slideShapes = sld.Shapes;

    // Hinzufügen einer Gruppenform zur Folie 
    IGroupShape groupShape = slideShapes.AddGroupShape();

    // Hinzufügen von Formen zur hinzugefügten Gruppenform 
    groupShape.Shapes.AddAutoShape(ShapeType.Rectangle, 300, 100, 100, 100);
    groupShape.Shapes.AddAutoShape(ShapeType.Rectangle, 500, 100, 100, 100);
    groupShape.Shapes.AddAutoShape(ShapeType.Rectangle, 300, 300, 100, 100);
    groupShape.Shapes.AddAutoShape(ShapeType.Rectangle, 500, 300, 100, 100);

    // Hinzufügen des Gruppenform-Frames 
    groupShape.Frame = new ShapeFrame(100, 300, 500, 40, NullableBool.False, NullableBool.False, 0);

    // PPTX-Datei auf die Festplatte schreiben 
    pres.Save("GroupShape_out.pptx", SaveFormat.Pptx);
}

Zugriff auf die AltText-Eigenschaft

Dieses Thema zeigt einfache Schritte, inklusive Codebeispielen, zum Hinzufügen einer Gruppenform und zum Zugriff auf die AltText-Eigenschaft von Gruppenformen auf Folien. Um den AltText einer Gruppenform in einer Folie mit Aspose.Slides für .NET zu erhalten:

1. Instanziieren Sie die Klasse Presentation, die eine PPTX-Datei darstellt.
2. Erhalten Sie die Referenz einer Folie, indem Sie deren Index verwenden.
3. Zugriff auf die Formensammlung der Folien.
4. Zugriff auf die Gruppenform.
5. Zugriff auf die AltText-Eigenschaft.

Das nachstehende Beispiel greift auf den Alternativtext der Gruppenform zu.

// Instanziieren der Presentation-Klasse, die eine PPTX-Datei darstellt
Presentation pres = new Presentation("AltText.pptx");

// Erste Folie abrufen
ISlide sld = pres.Slides[0];

for (int i = 0; i < sld.Shapes.Count; i++)
{
    // Zugriff auf die Formensammlung der Folien
    IShape shape = sld.Shapes[i];

    if (shape is GroupShape)
    {
        // Zugriff auf die Gruppenform.
        IGroupShape grphShape = (IGroupShape)shape;
        for (int j = 0; j < grphShape.Shapes.Count; j++)
        {
            IShape shape2 = grphShape.Shapes[j];
            // Zugriff auf die AltText-Eigenschaft
            Console.WriteLine(shape2.AlternativeText);
        }
    }
}

FAQ

Wird verschachteltes Gruppieren (eine Gruppe innerhalb einer Gruppe) unterstützt?

Ja. GroupShape verfügt über die Eigenschaft ParentGroup, die die Hierarchieunterstützung direkt anzeigt (eine Gruppe kann ein Kind einer anderen Gruppe sein).

Wie steuere ich die Z-Reihenfolge der Gruppe im Verhältnis zu anderen Objekten auf der Folie?

Verwenden Sie die Eigenschaft ZOrderPosition der GroupShape, um ihre Position im Anzeigestapel zu prüfen.

Kann ich das Verschieben/Bearbeiten/Entgruppieren verhindern?

Ja. Der Sperrbereich der Gruppe wird über GroupShapeLock bereitgestellt, wodurch Sie Vorgänge an dem Objekt einschränken können.