Gruppenpräsentationsformen in PHP

Gruppenform hinzufügen

Aspose.Slides unterstützt die Arbeit mit Gruppenformen auf Folien. Diese Funktion hilft Entwicklern, reichhaltigere Präsentationen zu unterstützen. Aspose.Slides for PHP via Java 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 füllen, oder auf irgendeine Eigenschaft der Gruppenform zuzugreifen. So fügen Sie einer Folie mit Aspose.Slides for PHP via Java eine Gruppenform hinzu:

1. Erstellen Sie eine Instanz der Presentation-Klasse.
2. Erhalten Sie die Referenz einer Folie, indem Sie ihren Index verwenden.
3. Fügen Sie der Folie eine Gruppenform hinzu.
4. Fügen Sie der hinzugefügten Gruppenform Formen hinzu.
5. Speichern Sie die geänderte Präsentation als PPTX‑Datei.

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

  # Instanziiere die Presentation-Klasse
  $pres = new Presentation();
  try {
    # Hole die erste Folie
    $sld = $pres->getSlides()->get_Item(0);
    # Zugriff auf die Shape-Sammlung der Folien
    $slideShapes = $sld->getShapes();
    # Hinzufügen einer Gruppenform zur Folie
    $groupShape = $slideShapes->addGroupShape();
    # Hinzufügen von Formen innerhalb der hinzugefügten Gruppenform
    $groupShape->getShapes()->addAutoShape(ShapeType::Rectangle, 300, 100, 100, 100);
    $groupShape->getShapes()->addAutoShape(ShapeType::Rectangle, 500, 100, 100, 100);
    $groupShape->getShapes()->addAutoShape(ShapeType::Rectangle, 300, 300, 100, 100);
    $groupShape->getShapes()->addAutoShape(ShapeType::Rectangle, 500, 300, 100, 100);
    # Hinzufügen des Gruppenformenrahmens
    $groupShape->setFrame(new ShapeFrame(100, 300, 500, 40, NullableBool::False, NullableBool::False, 0));
    # Schreibe die PPTX-Datei auf die Festplatte
    $pres->save("GroupShape.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Zugriff auf die AltText‑Eigenschaft

Dieses Thema zeigt einfache Schritte, komplett mit Codebeispielen, zum Hinzufügen einer Gruppenform und zum Zugriff auf die AltText‑Eigenschaft von Gruppenformen auf Folien. So greifen Sie mit Aspose.Slides for PHP via Java auf AltText einer Gruppenform in einer Folie zu:

1. Instanziieren Sie die Presentation-Klasse, die die PPTX‑Datei darstellt.
2. Erhalten Sie die Referenz einer Folie, indem Sie ihren Index verwenden.
3. Greifen Sie auf die Formen‑Sammlung der Folien zu.
4. Greifen Sie auf die Gruppenform zu.
5. Greifen Sie auf die Alternative Text-Eigenschaft zu.

Das Beispiel unten greift auf den Alternativtext einer Gruppenform zu.

  # Instanziiere die Presentation-Klasse, die die PPTX-Datei darstellt
  $pres = new Presentation("AltText.pptx");
  try {
    # Hole die erste Folie
    $sld = $pres->getSlides()->get_Item(0);
    for($i = 0; $i < java_values($sld->getShapes()->size()) ; $i++) {
      # Zugriff auf die Shape-Sammlung der Folien
      $shape = $sld->getShapes()->get_Item($i);
      if (java_instanceof($shape, new JavaClass("com.aspose.slides.GroupShape"))) {
        # Zugriff auf die Gruppenform.
        $grphShape = $shape;
        for($j = 0; $j < java_values($grphShape->getShapes()->size()) ; $j++) {
          $shape2 = $grphShape->getShapes()->get_Item($j);
          # Zugriff auf die AltText-Eigenschaft
          echo($shape2->getAlternativeText());
        }
      }
    }
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

FAQ

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

Ja. GroupShape verfügt über eine getParentGroup-Methode, die direkt die Unterstützung von Hierarchien anzeigt (eine Gruppe kann Kind einer anderen Gruppe sein).

Wie kann ich die Z‑Reihenfolge der Gruppe relativ zu anderen Objekten auf der Folie steuern?

Verwenden Sie die GroupShape‑Methode getZOrderPosition, um ihre Position im Anzeige‑Stack zu prüfen.

Kann ich das Verschieben/Bearbeiten/Entgruppieren verhindern?

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