Zarządzanie węzłami kształtu SmartArt w prezentacjach przy użyciu PHP

Przegląd

Grafika SmartArt w prezentacjach PowerPoint jest organizowana za pomocą węzłów zawierających tekst i definiujących strukturę diagramu. Aspose.Slides pozwala programowo pracować z tymi węzłami SmartArt: dodawać nowe węzły i węzły podrzędne, wstawiać węzły podrzędne w określonej pozycji, uzyskiwać dostęp do istniejących węzłów oraz odczytywać ich tekst, poziom i pozycję.

Ten artykuł wyjaśnia, jak zarządzać węzłami kształtów SmartArt. Pokazuje, jak usuwać węzły, pracować z węzłami podrzędnymi według indeksu lub pozycji, zmienić węzeł asystenta na zwykły węzeł, dostosować pozycję, rozmiar i obrót kształtów węzłów SmartArt, ustawić formaty wypełnienia węzłów oraz wygenerować miniaturkę dla węzła podrzędnego SmartArt.

Dodaj węzeł SmartArt

Aspose.Slides for PHP via Java udostępnia najprostsze API do zarządzania kształtami SmartArt w najłatwiejszy sposób. Poniższy przykładowy kod pomoże dodać węzeł i węzeł podrzędny wewnątrz kształtu SmartArt.

Utwórz instancję klasy Presentation i wczytaj prezentację z kształtem SmartArt.
Uzyskaj referencję do pierwszego slajdu, używając jego indeksu.
Przejdź przez wszystkie kształty wewnątrz pierwszego slajdu.
Sprawdź, czy kształt jest typu SmartArt i rzutuj wybrany kształt na SmartArt jeśli jest SmartArt.
Dodaj nowy węzeł w kształcie SmartArt NodeCollection i ustaw tekst w TextFrame.
Teraz, Dodaj Child Node w nowo dodanym węźle SmartArt i ustaw tekst w TextFrame.
Zapisz prezentację.

  # Wczytaj żądaną prezentację
  $pres = new Presentation("SimpleSmartArt.pptx");
  try {
    # Przejdź przez wszystkie kształty na pierwszym slajdzie
    foreach($pres->getSlides()->get_Item(0)->getShapes() as $shape) {
      # Sprawdź, czy kształt jest typu SmartArt
      if (java_instanceof($shape, new JavaClass("com.aspose.slides.SmartArt"))) {
        # Rzutuj kształt na SmartArt
        $smart = $shape;
        # Dodawanie nowego węzła SmartArt
        $TemNode = $smart->getAllNodes()->addNode();
        # Dodawanie tekstu
        $TemNode->getTextFrame()->setText("Test");
        # Dodawanie nowego węzła podrzędnego w węźle nadrzędnym. Zostanie dodany na końcu kolekcji
        $newNode = $TemNode->getChildNodes()->addNode();
        # Dodawanie tekstu
        $newNode->getTextFrame()->setText("New Node Added");
      }
    }
    # Zapisywanie prezentacji
    $pres->save("AddSmartArtNode.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Dodaj węzeł SmartArt w określonej pozycji

W poniższym przykładowym kodzie wyjaśniono, jak dodać węzły podrzędne należące do odpowiednich węzłów kształtu SmartArt w określonej pozycji.

Utwórz instancję klasy Presentation.
Uzyskaj referencję do pierwszego slajdu, używając jego indeksu.
Dodaj kształt SmartArt typu StackedList na wybranym slajdzie.
Uzyskaj dostęp do pierwszego węzła w dodanym kształcie SmartArt.
Teraz, dodaj Child Node dla wybranego Node na pozycji 2 i ustaw jego tekst.
Zapisz prezentację.

  # Tworzenie instancji prezentacji
  $pres = new Presentation();
  try {
    # Uzyskaj dostęp do slajdu prezentacji
    $slide = $pres->getSlides()->get_Item(0);
    # Dodaj Smart Art IShape
    $smart = $slide->getShapes()->addSmartArt(0, 0, 400, 400, SmartArtLayoutType::StackedList);
    # Uzyskiwanie dostępu do węzła SmartArt o indeksie 0
    $node = $smart->getAllNodes()->get_Item(0);
    # Dodawanie nowego węzła podrzędnego na pozycji 2 w węźle nadrzędnym
    $chNode = $node->getChildNodes()->addNodeByPosition(2);
    # Dodaj tekst
    $chNode->getTextFrame()->setText("Sample Text Added");
    # Zapisz prezentację
    $pres->save("AddSmartArtNodeByPosition.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Dostęp do węzła SmartArt

Poniższy przykładowy kod pomoże uzyskać dostęp do węzłów wewnątrz kształtu SmartArt. Należy zauważyć, że nie można zmienić LayoutType SmartArt, ponieważ jest on tylko do odczytu i jest ustawiany wyłącznie podczas dodawania kształtu SmartArt.

Utwórz instancję klasy Presentation i wczytaj prezentację z kształtem SmartArt.
Uzyskaj referencję do pierwszego slajdu, używając jego indeksu.
Przejdź przez wszystkie kształty wewnątrz pierwszego slajdu.
Sprawdź, czy kształt jest typu SmartArt i rzutuj wybrany kształt na SmartArt jeśli jest SmartArt.
Przejdź przez wszystkie Nodes wewnątrz kształtu SmartArt.
Dostęp i wyświetlenie informacji, takich jak pozycja węzła SmartArt, poziom i tekst.

  # Utwórz instancję klasy Presentation
  $pres = new Presentation("SmartArtShape.pptx");
  try {
    # Pobierz pierwszy slajd
    $slide = $pres->getSlides()->get_Item(0);
    # Przejdź przez wszystkie kształty na pierwszym slajdzie
    foreach($slide->getShapes() as $shape) {
      # Sprawdź, czy kształt jest typu SmartArt
      if (java_instanceof($shape, new JavaClass("com.aspose.slides.SmartArt"))) {
        # Rzutuj kształt na SmartArt
        $smart = $shape;
        # Przejdź przez wszystkie węzły wewnątrz SmartArt
        for($i = 0; $i < java_values($smart->getAllNodes()->size()) ; $i++) {
          # Uzyskiwanie dostępu do węzła SmartArt o indeksie i
          $node = $smart->getAllNodes()->get_Item($i);
          # Wyświetlanie parametrów węzła SmartArt
          System->out->print($node->getTextFrame()->getText() . " " . $node->getLevel() . " " . $node->getPosition());
        }
      }
    }
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Dostęp do węzła podrzędnego SmartArt

Poniższy przykładowy kod pomoże uzyskać dostęp do węzłów podrzędnych należących do odpowiednich węzłów kształtu SmartArt.

Utwórz instancję klasy Presentation i wczytaj prezentację z kształtem SmartArt.
Uzyskaj referencję do pierwszego slajdu, używając jego indeksu.
Przejdź przez wszystkie kształty wewnątrz pierwszego slajdu.
Sprawdź, czy kształt jest typu SmartArt i rzutuj wybrany kształt na SmartArt jeśli jest SmartArt.
Przejdź przez wszystkie Nodes wewnątrz kształtu SmartArt.
Dla każdego wybranego [Node] kształtu SmartArt, przejdź przez wszystkie Child Nodes wewnątrz danego węzła.
Dostęp i wyświetlenie informacji, takich jak pozycja, poziom i tekst Child Node.

  # Utwórz instancję klasy Presentation
  $pres = new Presentation("AccessChildNodes.pptx");
  try {
    # Pobierz pierwszy slajd
    $slide = $pres->getSlides()->get_Item(0);
    # Przejdź przez wszystkie kształty na pierwszym slajdzie
    foreach($slide->getShapes() as $shape) {
      # Sprawdź, czy kształt jest typu SmartArt
      if (java_instanceof($shape, new JavaClass("com.aspose.slides.SmartArt"))) {
        # Rzutuj kształt na SmartArt
        $smart = $shape;
        # Przejdź przez wszystkie węzły wewnątrz SmartArt
        for($i = 0; $i < java_values($smart->getAllNodes()->size()) ; $i++) {
          # Uzyskiwanie dostępu do węzła SmartArt o indeksie i
          $node0 = $smart->getAllNodes()->get_Item($i);
          # Przechodzenie przez węzły podrzędne w węźle SmartArt o indeksie i
          for($j = 0; $j < java_values($node0->getChildNodes()->size()) ; $j++) {
            # Uzyskiwanie dostępu do węzła podrzędnego w węźle SmartArt
            $node = $node0->getChildNodes()->get_Item($j);
            # Wyświetlanie parametrów węzła podrzędnego SmartArt
            System->out->print("j = " . $j . ", Text = " . $node->getTextFrame()->getText() . ",  Level = " . $node->getLevel() . ", Position = " . $node->getPosition());
          }
        }
      }
    }
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Dostęp do węzła podrzędnego SmartArt w określonej pozycji

W tym przykładzie nauczymy się uzyskiwać dostęp do węzłów podrzędnych w określonych pozycjach, należących do odpowiednich węzłów kształtu SmartArt.

Utwórz instancję klasy Presentation.
Uzyskaj referencję do pierwszego slajdu, używając jego indeksu.
Dodaj kształt SmartArt typu StackedList.
Uzyskaj dostęp do dodanego kształtu SmartArt.
Uzyskaj dostęp do węzła o indeksie 0 w wybranym kształcie SmartArt.
Teraz, uzyskaj dostęp do Child Node na pozycji 1 w wybranym węźle SmartArt używając metody get_Item().
Dostęp i wyświetlenie informacji, takich jak pozycja, poziom i tekst [Child Node].

  # Utwórz instancję prezentacji
  $pres = new Presentation();
  try {
    # Uzyskiwanie dostępu do pierwszego slajdu
    $slide = $pres->getSlides()->get_Item(0);
    # Dodawanie kształtu SmartArt na pierwszym slajdzie
    $smart = $slide->getShapes()->addSmartArt(0, 0, 400, 400, SmartArtLayoutType::StackedList);
    # Uzyskiwanie dostępu do węzła SmartArt o indeksie 0
    $node = $smart->getAllNodes()->get_Item(0);
    # Uzyskiwanie dostępu do węzła podrzędnego na pozycji 1 w węźle nadrzędnym
    $position = 1;
    $chNode = $node->getChildNodes()->get_Item($position);
    # Wyświetlanie parametrów węzła podrzędnego SmartArt
    System->out->print("Text = " . $chNode->getTextFrame()->getText() . ",  Level = " . $chNode->getLevel() . ", Position = " . $chNode->getPosition());
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Usuń węzeł SmartArt

W tym przykładzie nauczymy się usuwać węzły wewnątrz kształtu SmartArt.

Utwórz instancję klasy Presentation i wczytaj prezentację z kształtem SmartArt.
Uzyskaj referencję do pierwszego slajdu, używając jego indeksu.
Przejdź przez wszystkie kształty wewnątrz pierwszego slajdu.
Sprawdź, czy kształt jest typu SmartArt i rzutuj wybrany kształt na SmartArt jeśli jest SmartArt.
Sprawdź, czy SmartArt ma więcej niż 0 węzłów.
Wybierz węzeł SmartArt do usunięcia.
Teraz, usuń wybrany węzeł używając metody removeNode.
Zapisz prezentację.

  # Wczytaj żądaną prezentację
  $pres = new Presentation("AddSmartArtNode.pptx");
  try {
    # Przejdź przez wszystkie kształty na pierwszym slajdzie
    foreach($pres->getSlides()->get_Item(0)->getShapes() as $shape) {)
      # Sprawdź, czy kształt jest typu SmartArt
      if (java_instanceof($shape, new JavaClass("com.aspose.slides.SmartArt"))) {
        # Rzutuj kształt na SmartArt
        $smart = $shape;
        if (java_values($smart->getAllNodes()->size()) > 0) {
          # Uzyskiwanie dostępu do węzła SmartArt o indeksie 0
          $node = $smart->getAllNodes()->get_Item(0);
          # Usuwanie wybranego węzła
          $smart->getAllNodes()->removeNode($node);
        }
      }
    }
    # Zapisz prezentację
    $pres->save("RemoveSmartArtNode.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Usuń węzeł SmartArt z określonej pozycji

W tym przykładzie nauczymy się usuwać węzły wewnątrz kształtu SmartArt w konkretnej pozycji.

Utwórz instancję klasy Presentation i wczytaj prezentację z kształtem SmartArt.
Uzyskaj referencję do pierwszego slajdu, używając jego indeksu.
Przejdź przez wszystkie kształty wewnątrz pierwszego slajdu.
Sprawdź, czy kształt jest typu SmartArt i rzutuj wybrany kształt na SmartArt jeśli jest SmartArt.
Wybierz węzeł kształtu SmartArt o indeksie 0.
Teraz, sprawdź, czy wybrany węzeł SmartArt ma więcej niż 2 węzły podrzędne.
Teraz, usuń węzeł na Pozycji 1 używając metody removeNode.
Zapisz prezentację.

  # Wczytaj żądaną prezentację
  $pres = new Presentation("AddSmartArtNode.pptx");
  try {
    # Przejdź przez wszystkie kształty na pierwszym slajdzie
    foreach($pres->getSlides()->get_Item(0)->getShapes() as $shape) {)
      # Sprawdź, czy kształt jest typu SmartArt
      if (java_instanceof($shape, new JavaClass("com.aspose.slides.SmartArt"))) {
        # Rzutuj kształt na SmartArt
        $smart = $shape;
        if (java_values($smart->getAllNodes()->size()) > 0) {
          # Uzyskiwanie dostępu do węzła SmartArt o indeksie 0
          $node = $smart->getAllNodes()->get_Item(0);
          if (java_values($node->getChildNodes()->size()) >= 2) {
            # Usuwanie węzła podrzędnego na pozycji 1
            $node->getChildNodes()->removeNode(1);
          }
        }
      }
    }
    # Zapisz prezentację
    $pres->save("RemoveSmartArtNodeByPosition.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Ustaw niestandardową pozycję dla węzła podrzędnego w obiekcie SmartArt

Aspose.Slides for PHP via Java obsługuje ustawianie właściwości SmartArtShape X i Y. Poniższy fragment kodu pokazuje, jak ustawić niestandardową pozycję, rozmiar i obrót SmartArtShape; należy również zauważyć, że dodawanie nowych węzłów powoduje przeliczenie pozycji i rozmiarów wszystkich węzłów. Dzięki ustawieniom niestandardowej pozycji użytkownik może ustawiać węzły zgodnie z wymaganiami.

  # Utwórz instancję klasy Presentation
  $pres = new Presentation("SimpleSmartArt.pptx");
  try {
    $smart = $pres->getSlides()->get_Item(0)->getShapes()->addSmartArt(20, 20, 600, 500, SmartArtLayoutType::OrganizationChart);
    # Przenieś kształt SmartArt na nową pozycję
    $node = $smart->getAllNodes()->get_Item(1);
    $shape = $node->getShapes()->get_Item(1);
    $shape->setX($shape->getX() . $shape->getWidth() * 2);
    $shape->setY($shape->getY() - $shape->getHeight() * 2);
    # Zmień szerokości kształtu SmartArt
    $node = $smart->getAllNodes()->get_Item(2);
    $shape = $node->getShapes()->get_Item(1);
    $shape->setWidth($shape->getWidth() . $shape->getWidth() * 2);
    # Zmień wysokość kształtu SmartArt
    $node = $smart->getAllNodes()->get_Item(3);
    $shape = $node->getShapes()->get_Item(1);
    $shape->setHeight($shape->getHeight() . $shape->getHeight() * 2);
    # Zmień obrót kształtu SmartArt
    $node = $smart->getAllNodes()->get_Item(4);
    $shape = $node->getShapes()->get_Item(1);
    $shape->setRotation(90);
    $pres->save("SmartArt.pptx", SaveFormat::Pptx);
  } finally {
    $pres->dispose();
  }

Sprawdź węzeł asystenta

W tym artykule przyjrzymy się dalej funkcjom kształtów SmartArt dodawanych do slajdów prezentacji programowo przy użyciu Aspose.Slides for PHP via Java.

Użyjemy następującego źródłowego kształtu SmartArt do naszych badań w różnych sekcjach tego artykułu.


Rysunek: Źródłowy kształt SmartArt na slajdzie

W poniższym przykładowym kodzie zbadamy, jak zidentyfikować Assistant Nodes w kolekcji węzłów SmartArt i jak je zmienić.

Utwórz instancję klasy Presentation i wczytaj prezentację z kształtem SmartArt.
Uzyskaj referencję do drugiego slajdu, używając jego indeksu.
Przejdź przez wszystkie kształty wewnątrz pierwszego slajdu.
Sprawdź, czy kształt jest typu SmartArt i rzutuj wybrany kształt na SmartArt jeśli jest SmartArt.
Przejdź przez wszystkie węzły wewnątrz kształtu SmartArt i sprawdź, czy są Assistant Nodes.
Zmień status węzła Assistant na zwykły węzeł.
Zapisz prezentację.

  # Tworzenie instancji prezentacji
  $pres = new Presentation("AddNodes.pptx");
  try {
    # Przejdź przez wszystkie kształty na pierwszym slajdzie
    foreach($pres->getSlides()->get_Item(0)->getShapes() as $shape) {)
      # Sprawdź, czy kształt jest typu SmartArt
      if (java_instanceof($shape, new JavaClass("com.aspose.slides.SmartArt"))) {
        # Rzutuj kształt na SmartArt
        $smart = $shape;
        # Przejście przez wszystkie węzły kształtu SmartArt
        for($i = 0; $i < java_values($smart->getAllNodes()->size()) ; $i++) {
          $node = $smart->getAllNodes()->get_Item($i);
          # Sprawdź, czy węzeł jest węzłem asystenta
          if ($node->isAssistant()) {
            # Ustawienie węzła asystenta na false i zamiana go na zwykły węzeł
            $node->isAssistant();
          }
        }
      }
    }
    # Zapisz prezentację
    $pres->save("ChangeAssitantNode.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }


Rysunek: Zmodyfikowane węzły Assistant w kształcie SmartArt na slajdzie

Ustaw format wypełnienia węzła

Aspose.Slides for PHP via Java umożliwia dodawanie niestandardowych kształtów SmartArt i ustawianie ich formatu wypełnienia. Ten artykuł wyjaśnia, jak tworzyć i uzyskiwać dostęp do kształtów SmartArt oraz ustawiać ich format wypełnienia przy użyciu Aspose.Slides for PHP via Java.

Proszę wykonać poniższe kroki:

Utwórz instancję klasy Presentation.
Uzyskaj referencję do slajdu, używając jego indeksu.
Dodaj kształt SmartArt ustawiając jego LayoutType.
Ustaw Fill Format dla węzłów kształtu SmartArt.
Napisz zmodyfikowaną prezentację jako plik PPTX.

  # Utwórz instancję prezentacji
  $pres = new Presentation();
  try {
    # Uzyskiwanie dostępu do slajdu
    $slide = $pres->getSlides()->get_Item(0);
    # Dodawanie kształtu SmartArt i węzłów
    $chevron = $slide->getShapes()->addSmartArt(10, 10, 800, 60, SmartArtLayoutType::ClosedChevronProcess);
    $node = $chevron->getAllNodes()->addNode();
    $node->getTextFrame()->setText("Some text");
    # Ustawianie koloru wypełnienia węzła
    foreach($node->getShapes() as $item) {
      $item->getFillFormat()->setFillType(FillType::Solid);
      $item->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
    }
    # Zapisz prezentację
    $pres->save("TestSmart.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Wygeneruj miniaturę węzła podrzędnego SmartArt

Programiści mogą wygenerować miniaturę węzła podrzędnego SmartArt, wykonując poniższe kroki:

Utwórz instancję klasy Presentation.
Dodaj SmartArt.
Uzyskaj referencję do węzła, używając jego indeksu.
Pobierz obraz miniatury.
Zapisz obraz miniatury w dowolnym wybranym formacie obrazu.

  # Utwórz obiekt klasy Presentation reprezentujący plik PPTX
  $pres = new Presentation();
  try {
    # Dodaj SmartArt
    $smart = $pres->getSlides()->get_Item(0)->getShapes()->addSmartArt(10, 10, 400, 300, SmartArtLayoutType::BasicCycle);
    # Uzyskaj referencję do węzła używając jego indeksu
    $node = $smart->getNodes()->get_Item(1);
    # Pobierz miniaturkę
    $slideImage = $node->getShapes()->get_Item(0)->getImage();
    # Zapisz miniaturkę
    try {
      $slideImage->save("SmartArt_ChildNote_Thumbnail.png", ImageFormat::Png);
    } finally {
      if (!java_is_null($slideImage)) {
        $slideImage->dispose();
      }
    }
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

FAQ

Czy obsługiwana jest animacja SmartArt?

Tak. SmartArt jest traktowany jako zwykły kształt, więc możesz zastosować standardowe animacje (wejścia, wyjścia, podkreślenia, ścieżki ruchu) i dostosować ich czas. Możesz również animować kształty wewnątrz węzłów SmartArt w razie potrzeby.

Jak mogę niezawodnie zlokalizować konkretny SmartArt na slajdzie, jeśli jego wewnętrzny identyfikator jest nieznany?

Przypisz i wyszukuj według alternatywnego tekstu. Ustawienie charakterystycznego AltText na SmartArt umożliwia programowe odnalezienie go bez polegania na wewnętrznych identyfikatorach.

Czy wygląd SmartArt zostanie zachowany przy konwersji prezentacji do PDF?

Tak. Aspose.Slides renderuje SmartArt z wysoką wiernością wizualną podczas eksportu do PDF, zachowując układ, kolory i efekty.

Czy mogę wyodrębnić obraz całego SmartArt (do podglądów lub raportów)?

Tak. Możesz renderować kształt SmartArt do formatów rastrowych lub do SVG w celu uzyskania skalowalnego wektora, co sprawia, że nadaje się do miniatur, raportów lub użytku w sieci.

Zarządzanie grafikami SmartArt w prezentacjach przy użyciu PHP