Gestisci i connettori nelle presentazioni usando PHP

Introduzione

Un connettore PowerPoint è una linea speciale che collega o unisce due forme insieme e rimane attaccato alle forme anche quando vengono spostate o riposizionate su una diapositiva.

I connettori sono tipicamente collegati a punti di connessione (punti verdi), che esistono su tutte le forme per impostazione predefinita. I punti di connessione appaiono quando il cursore si avvicina a loro.

Punti di regolazione (punti arancioni), che esistono solo su alcuni connettori, sono usati per modificare le posizioni e le forme dei connettori.

Tipi di connettori

In PowerPoint, è possibile utilizzare connettori diritti, a gomito (angolati) e curvi.

Aspose.Slides fornisce questi connettori:

Connettore Immagine Numero di punti di regolazione
ShapeType::Line shapetype-lineconnector 0
ShapeType::StraightConnector1 shapetype-straightconnector1 0
ShapeType::BentConnector2 shapetype-bent-connector2 0
ShapeType::BentConnector3 shapetype-bentconnector3 1
ShapeType::BentConnector4 shapetype-bentconnector4 2
ShapeType::BentConnector5 shapetype-bentconnector5 3
ShapeType::CurvedConnector2 shapetype-curvedconnector2 0
ShapeType::CurvedConnector3 shapetype-curvedconnector3 1
ShapeType::CurvedConnector4 shapetype-curvedconnector4 2
ShapeType::CurvedConnector5 shapetype.curvedconnector5 3

Collegare le forme usando i connettori

  1. Crea un’istanza della classe Presentation.
  2. Ottieni un riferimento alla diapositiva tramite il suo indice.
  3. Aggiungi due AutoShape alla diapositiva usando il metodo addAutoShape esposto dall’oggetto Shapes.
  4. Aggiungi un connettore usando il metodo addConnector esposto dall’oggetto Shapes definendo il tipo di connettore.
  5. Collega le forme usando il connettore.
  6. Chiama il metodo reroute per applicare il percorso di connessione più breve.
  7. Salva la presentazione.

Questo codice PHP mostra come aggiungere un connettore (un connettore piegato) tra due forme (un’ellisse e un rettangolo):

// Istanzia una classe di presentazione che rappresenta il file PPTX
  $pres = new Presentation();
  try {
    # Accede alla collezione di forme per una diapositiva specifica
    $shapes = $pres->getSlides()->get_Item(0)->getShapes();
    # Aggiunge una forma automatica ellisse
    $ellipse = $shapes->addAutoShape(ShapeType::Ellipse, 0, 100, 100, 100);
    # Aggiunge una forma automatica rettangolo
    $rectangle = $shapes->addAutoShape(ShapeType::Rectangle, 100, 300, 100, 100);
    # Aggiunge una forma di connettore alla collezione di forme della diapositiva
    $connector = $shapes->addConnector(ShapeType::BentConnector2, 0, 0, 10, 10);
    # Collega le forme usando il connettore
    $connector->setStartShapeConnectedTo($ellipse);
    $connector->setEndShapeConnectedTo($rectangle);
    # Chiama reroute che imposta il percorso più breve automatico tra le forme
    $connector->reroute();
    # Salva la presentazione
    $pres->save("output.pptx", SaveFormat::Pptx);
} finally {
    if (!java_is_null($pres)) $pres.dispose();
}

Specificare un punto di connessione

Se desideri che un connettore colleghi due forme usando punti specifici sulle forme, devi specificare i punti di connessione preferiti in questo modo:

  1. Crea un’istanza della classe Presentation.
  2. Ottieni un riferimento alla diapositiva tramite il suo indice.
  3. Aggiungi due AutoShape alla diapositiva usando il metodo addAutoShape esposto dall’oggetto Shapes.
  4. Aggiungi un connettore usando il metodo addConnector esposto dall’oggetto Shapes definendo il tipo di connettore.
  5. Collega le forme usando il connettore.
  6. Imposta i punti di connessione preferiti sulle forme.
  7. Salva la presentazione.

Questo codice PHP dimostra un’operazione in cui viene specificato un punto di connessione preferito:

  # Istanzia una classe di presentazione che rappresenta un file PPTX
  $pres = new Presentation();
  try {
    # Accede alla collezione di forme per una diapositiva specifica
    $shapes = $pres->getSlides()->get_Item(0)->getShapes();
    # Aggiunge una forma automatica ellisse
    $ellipse = $shapes->addAutoShape(ShapeType::Ellipse, 0, 100, 100, 100);
    # Aggiunge una forma automatica rettangolo
    $rectangle = $shapes->addAutoShape(ShapeType::Rectangle, 100, 300, 100, 100);
    # Aggiunge una forma di connettore alla collezione di forme della diapositiva
    $connector = $shapes->addConnector(ShapeType::BentConnector2, 0, 0, 10, 10);
    # Collega le forme usando il connettore
    $connector->setStartShapeConnectedTo($ellipse);
    $connector->setEndShapeConnectedTo($rectangle);
    # Imposta l'indice del punto di connessione preferito sulla forma ellisse
    $wantedIndex = 6;
    # Verifica se l'indice preferito è minore del conteggio massimo dei punti di connessione
    if ($ellipse->getConnectionSiteCount() > $wantedIndex) {
      # Imposta il punto di connessione preferito sulla forma automatica ellisse
      $connector->setStartShapeConnectionSiteIndex($wantedIndex);
    }
    # Salva la presentazione
    $pres->save("output.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Regolare un punto del connettore

Puoi regolare un connettore esistente tramite i suoi punti di regolazione. Solo i connettori con punti di regolazione possono essere modificati in questo modo. Vedi la tabella sotto Tipi di connettori.

Caso semplice

Considera un caso in cui un connettore tra due forme (A e B) passa attraverso una terza forma (C):

connector-obstruction

  $pres = new Presentation();
  try {
    $sld = $pres->getSlides()->get_Item(0);
    $shape = $sld->getShapes()->addAutoShape(ShapeType::Rectangle, 300, 150, 150, 75);
    $shapeFrom = $sld->getShapes()->addAutoShape(ShapeType::Rectangle, 500, 400, 100, 50);
    $shapeTo = $sld->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 70, 30);
    $connector = $sld->getShapes()->addConnector(ShapeType::BentConnector5, 20, 20, 400, 300);
    $connector->getLineFormat()->setEndArrowheadStyle(LineArrowheadStyle->Triangle);
    $connector->getLineFormat()->getFillFormat()->setFillType(FillType::Solid);
    $connector->getLineFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    $connector->setStartShapeConnectedTo($shapeFrom);
    $connector->setEndShapeConnectedTo($shapeTo);
    $connector->setStartShapeConnectionSiteIndex(2);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Per evitare o aggirare la terza forma, possiamo regolare il connettore spostando la sua linea verticale verso sinistra in questo modo:

connector-obstruction-fixed

  $adj2 = $connector->getAdjustments()->get_Item(1);
  $adj2->setRawValue($adj2->getRawValue() + 10000);

Casi complessi

Per eseguire regolazioni più complesse, devi tenere in considerazione i seguenti aspetti:

  • Il punto regolabile di un connettore è fortemente legato a una formula che calcola e determina la sua posizione. Pertanto, le modifiche alla posizione del punto possono alterare la forma del connettore.
  • I punti di regolazione di un connettore sono definiti in un ordine rigoroso in un array. I punti di regolazione sono numerati dal punto di inizio del connettore al suo punto finale.
  • I valori dei punti di regolazione riflettono la percentuale della larghezza/altezza della forma del connettore.
    • La forma è delimitata dai punti di inizio e fine del connettore moltiplicati per 1000.
    • Il primo punto, il secondo punto e il terzo punto definiscono rispettivamente la percentuale rispetto alla larghezza, la percentuale rispetto all’altezza e nuovamente la percentuale rispetto alla larghezza.
  • Per i calcoli che determinano le coordinate dei punti di regolazione di un connettore, devi considerare la rotazione del connettore e la sua riflessione. Nota che l’angolo di rotazione per tutti i connettori mostrati sotto Tipi di connettori è 0.

Caso 1

Considera un caso in cui due oggetti di riquadro di testo sono collegati tramite un connettore:

connector-shape-complex

  # Istanzia una classe di presentazione che rappresenta un file PPTX
  $pres = new Presentation();
  try {
    # Ottiene la prima diapositiva nella presentazione
    $sld = $pres->getSlides()->get_Item(0);
    # Aggiunge forme che saranno unite tramite un connettore
    $shapeFrom = $sld->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 60, 25);
    $shapeFrom->getTextFrame()->setText("From");
    $shapeTo = $sld->getShapes()->addAutoShape(ShapeType::Rectangle, 500, 100, 60, 25);
    $shapeTo->getTextFrame()->setText("To");
    # Aggiunge un connettore
    $connector = $sld->getShapes()->addConnector(ShapeType::BentConnector4, 20, 20, 400, 300);
    # Specifica la direzione del connettore
    $connector->getLineFormat()->setEndArrowheadStyle(LineArrowheadStyle->Triangle);
    # Specifica il colore del connettore
    $connector->getLineFormat()->getFillFormat()->setFillType(FillType::Solid);
    $connector->getLineFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
    # Specifica lo spessore della linea del connettore
    $connector->getLineFormat()->setWidth(3);
    # Collega le forme insieme con il connettore
    $connector->setStartShapeConnectedTo($shapeFrom);
    $connector->setStartShapeConnectionSiteIndex(3);
    $connector->setEndShapeConnectedTo($shapeTo);
    $connector->setEndShapeConnectionSiteIndex(2);
    # Ottiene i punti di regolazione per il connettore
    $adjValue_0 = $connector->getAdjustments()->get_Item(0);
    $adjValue_1 = $connector->getAdjustments()->get_Item(1);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Regolazione

Possiamo cambiare i valori dei punti di regolazione del connettore aumentando la percentuale di larghezza e altezza corrispondente del 20% e del 200%, rispettivamente:

  # Modifica i valori dei punti di regolazione
  $adjValue_0->setRawValue($adjValue_0->getRawValue() + 20000);
  $adjValue_1->setRawValue($adjValue_1->getRawValue() + 200000);

Il risultato:

connector-adjusted-1

Per definire un modello che ci permetta di determinare le coordinate e la forma delle singole parti del connettore, creiamo una forma che corrisponda alla componente orizzontale del connettore nel punto connector.getAdjustments().get_Item(0):

  # Disegna la componente verticale del connettore
  $x = $connector->getX() . $connector->getWidth() * $adjValue_0->getRawValue() / 100000;
  $y = $connector->getY();
  $height = $connector->getHeight() * $adjValue_1->getRawValue() / 100000;
  $sld->getShapes()->addAutoShape(ShapeType::Rectangle, $x, $y, 0, $height);

Il risultato:

connector-adjusted-2

Caso 2

Nella Caso 1, abbiamo mostrato un’operazione di regolazione del connettore semplice usando principi di base. In situazioni normali, devi considerare la rotazione del connettore e la sua visualizzazione (che sono impostate da connector.getRotation(), connector.getFrame().getFlipH() e connector.getFrame().getFlipV()). Ora dimostreremo il processo.

Prima, aggiungiamo un nuovo oggetto di riquadro di testo (To 1) alla diapositiva (per scopi di connessione) e creiamo un nuovo connettore (verde) che lo collega agli oggetti già creati.

  # Crea un nuovo oggetto di binding
  $shapeTo_1 = $sld->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 400, 60, 25);
  $shapeTo_1->getTextFrame()->setText("To 1");
  # Crea un nuovo connettore
  $connector = $sld->getShapes()->addConnector(ShapeType::BentConnector4, 20, 20, 400, 300);
  $connector->getLineFormat()->setEndArrowheadStyle(LineArrowheadStyle->Triangle);
  $connector->getLineFormat()->getFillFormat()->setFillType(FillType::Solid);
  $connector->getLineFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->CYAN);
  $connector->getLineFormat()->setWidth(3);
  # Collega gli oggetti usando il nuovo connettore creato
  $connector->setStartShapeConnectedTo($shapeFrom);
  $connector->setStartShapeConnectionSiteIndex(2);
  $connector->setEndShapeConnectedTo($shapeTo_1);
  $connector->setEndShapeConnectionSiteIndex(3);
  # Ottiene i punti di regolazione del connettore
  $adjValue_0 = $connector->getAdjustments()->get_Item(0);
  $adjValue_1 = $connector->getAdjustments()->get_Item(1);
  # Modifica i valori dei punti di regolazione
  $adjValue_0->setRawValue($adjValue_0->getRawValue() + 20000);
  $adjValue_1->setRawValue($adjValue_1->getRawValue() + 200000);

Il risultato:

connector-adjusted-3

Secondo, creiamo una forma che corrisponda alla componente orizzontale del connettore che passa attraverso il nuovo punto di regolazione del connettore connector.getAdjustments().get_Item(0). Useremo i valori dei dati del connettore per connector.getRotation(), connector.getFrame().getFlipH() e connector.getFrame().getFlipV() e applicheremo la nota formula di conversione delle coordinate per la rotazione intorno a un punto dato x0:

X = (x — x0) * cos(alpha) — (y — y0) * sin(alpha) + x0; Y = (x — x0) * sin(alpha) + (y — y0) * cos(alpha) + y0;

Nel nostro caso, l’angolo di rotazione dell’oggetto è 90 gradi e il connettore è visualizzato verticalmente, quindi questo è il codice corrispondente:

  # Salva le coordinate del connettore
  $x = $connector->getX();
  $y = $connector->getY();
  # Corregge le coordinate del connettore nel caso appaia
  if ($connector->getFrame()->getFlipH() == NullableBool::True) {
    $x += $connector->getWidth();
  }
  if ($connector->getFrame()->getFlipV() == NullableBool::True) {
    $y += $connector->getHeight();
  }
  # Prende il valore del punto di regolazione come coordinata
  $x += $connector->getWidth() * $adjValue_0->getRawValue() / 100000;
  # Converte le coordinate poiché Sin(90) = 1 e Cos(90) = 0
  $xx = $connector->getFrame()->getCenterX() - $y . $connector->getFrame()->getCenterY();
  $yy = $x - $connector->getFrame()->getCenterX() . $connector->getFrame()->getCenterY();
  # Determina la larghezza della componente orizzontale usando il valore del secondo punto di regolazione
  $width = $connector->getHeight() * $adjValue_1->getRawValue() / 100000;
  $shape = $sld->getShapes()->addAutoShape(ShapeType::Rectangle, $xx, $yy, $width, 0);
  $shape->getLineFormat()->getFillFormat()->setFillType(FillType::Solid);
  $shape->getLineFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);

Il risultato:

connector-adjusted-4

Abbiamo dimostrato calcoli riguardanti regolazioni semplici e punti di regolazione complessi (punti di regolazione con angoli di rotazione). Utilizzando le conoscenze acquisite, puoi sviluppare il tuo modello (o scrivere del codice) per ottenere un oggetto GraphicsPath o persino impostare i valori dei punti di regolazione di un connettore basati su coordinate specifiche della diapositiva.

Trovare l’angolo delle linee del connettore

  1. Crea un’istanza della classe.
  2. Ottieni un riferimento alla diapositiva tramite il suo indice.
  3. Accedi alla forma della linea del connettore.
  4. Usa la larghezza della linea, l’altezza, l’altezza del frame della forma e la larghezza del frame della forma per calcolare l’angolo.

Questo codice PHP dimostra un’operazione in cui abbiamo calcolato l’angolo per una forma di linea del connettore:

  $pres = new Presentation("ConnectorLineAngle.pptx");
  try {
    $slide = $pres->getSlides()->get_Item(0);
    for($i = 0; $i < java_values($slide->getShapes()->size()) ; $i++) {
      $dir = 0.0;
      $shape = $slide->getShapes()->get_Item($i);
      if (java_instanceof($shape, new JavaClass("com.aspose.slides.AutoShape"))) {
        $ashp = $shape;
        if ($ashp->getShapeType() == ShapeType::Line) {
          $dir = getDirection($ashp->getWidth(), $ashp->getHeight(), java_values($ashp->getFrame()->getFlipH()) > 0, $ashp->getFrame()->getFlipV() > 0);
        }
      } else if (java_instanceof($shape, new JavaClass("com.aspose.slides.Connector"))) {
        $ashp = $shape;
        $dir = getDirection($ashp->getWidth(), $ashp->getHeight(), java_values($ashp->getFrame()->getFlipH()) > 0, java_values($ashp->getFrame()->getFlipV()) > 0);
      }
      echo($dir);
    }
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

FAQ

Come posso capire se un connettore può essere “incollato” a una forma specifica?

Verifica che la forma esponga punti di connessione. Se non ce ne sono o il conteggio è zero, l’incollaggio non è disponibile; in tal caso, usa estremità libere e posizionale manualmente. È consigliabile controllare il conteggio dei punti prima di collegare.

Cosa succede a un connettore se elimino una delle forme collegate?

Le sue estremità verranno staccate; il connettore rimane sulla diapositiva come una linea ordinaria con inizio/fine liberi. Puoi eliminarlo o riassegnare le connessioni e, se necessario, reroute.

I collegamenti dei connettori vengono mantenuti quando si copia una diapositiva in un’altra presentazione?

Generalmente sì, a condizione che anche le forme di destinazione vengano copiate. Se la diapositiva viene inserita in un altro file senza le forme collegate, le estremità diventano libere e sarà necessario ricollegarle.

Personalizza le forme di presentazione in PHP