Beheer connectoren in presentaties met Java

Inleiding

Een PowerPoint‑connector is een speciale lijn die twee vormen met elkaar verbindt of linkt en aan de vormen blijft bevestigd, zelfs wanneer ze worden verplaatst of opnieuw gepositioneerd op een dia.

Connectoren worden doorgaans verbonden met verbindingspunten (groene stippen), die standaard op alle vormen aanwezig zijn. Verbindingspunten verschijnen wanneer de cursor er dichtbij komt.

Aanpassingspunten (oranje stippen), die alleen op bepaalde connectoren bestaan, worden gebruikt om de positie en vorm van connectoren aan te passen.

Soorten connectoren

In PowerPoint kun je rechte, elleboog‑ (hoekige) en kromme connectoren gebruiken.

Aspose.Slides biedt deze connectoren:

Connector Afbeelding Aantal aanpassingspunten
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

Vormen verbinden met connectoren

  1. Maak een instantie van de Presentatie‑klasse.
  2. Haal de referentie van een dia op via de index.
  3. Voeg twee AutoShape toe aan de dia met behulp van de addAutoShape‑methode die wordt aangeboden door het Shapes‑object.
  4. Voeg een connector toe met de addConnector‑methode van het Shapes‑object door het connector‑type te definiëren.
  5. Verbind de vormen met de connector.
  6. Roep de reroute‑methode aan om het kortste verbindingspad toe te passen.
  7. Sla de presentatie op.

Deze Java‑code laat zien hoe je een connector (een gebogen connector) tussen twee vormen (een ellips en een rechthoek) toevoegt:

// Instantieert een presentatieklasse die het PPTX-bestand vertegenwoordigt
Presentation pres = new Presentation();
try {
    // Toegang tot de vormenverzameling voor een specifieke dia
    IShapeCollection shapes = pres.getSlides().get_Item(0).getShapes();
    
    // Voegt een ellips-autovorm toe
    IAutoShape ellipse = shapes.addAutoShape(ShapeType.Ellipse, 0, 100, 100, 100);
    
    // Voegt een rechthoek-autovorm toe
    IAutoShape rectangle = shapes.addAutoShape(ShapeType.Rectangle, 100, 300, 100, 100);
    
    // Voegt een connectorvorm toe aan de vormenverzameling van de dia
    IConnector connector = shapes.addConnector(ShapeType.BentConnector2, 0, 0, 10, 10);
    
    // Verbindt de vormen met de connector
    connector.setStartShapeConnectedTo(ellipse);
    connector.setEndShapeConnectedTo(rectangle);
    
    // Roept reroute aan die het automatische kortste pad tussen vormen bepaalt
    connector.reroute();
    
    // Slaat de presentatie op
    pres.save("output.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Specificeer een verbindingspunt

Als je een connector wilt laten koppelen aan twee vormen via specifieke punten op de vormen, moet je de gewenste verbindingspunten als volgt opgeven:

  1. Maak een instantie van de Presentatie‑klasse.
  2. Haal de referentie van een dia op via de index.
  3. Voeg twee AutoShape toe aan de dia met behulp van de addAutoShape‑methode die wordt aangeboden door het Shapes‑object.
  4. Voeg een connector toe met de addConnector‑methode van het Shapes‑object door het connector‑type te definiëren.
  5. Verbind de vormen met de connector.
  6. Stel je gewenste verbindingspunten op de vormen in.
  7. Sla de presentatie op.

Deze Java‑code toont een bewerking waarbij een voorkeurs‑verbindingspunt wordt gespecificeerd:

// Instantieert een presentatieklasse die een PPTX-bestand vertegenwoordigt
Presentation pres = new Presentation();
try {
    // Toegang tot de vormenverzameling voor een specifieke dia
    IShapeCollection shapes = pres.getSlides().get_Item(0).getShapes();

    // Voeg een ellips-autovorm toe
    IAutoShape ellipse = shapes.addAutoShape(ShapeType.Ellipse, 0, 100, 100, 100);

    // Voeg een rechthoek-autovorm toe
    IAutoShape rectangle = shapes.addAutoShape(ShapeType.Rectangle, 100, 300, 100, 100);

    // Voegt een connectorvorm toe aan de vormenverzameling van de dia
    IConnector connector = shapes.addConnector(ShapeType.BentConnector2, 0, 0, 10, 10);

    // Verbindt de vormen met de connector
    connector.setStartShapeConnectedTo(ellipse);
    connector.setEndShapeConnectedTo(rectangle);

    // Stelt de gewenste index van het verbindingspunt in op de ellipsvorm
    int wantedIndex = 6;

    // Controleert of de gewenste index kleiner is dan het maximale aantal verbindingssites
    if (ellipse.getConnectionSiteCount() > wantedIndex) 
    {
        // Stelt het gewenste verbindingspunt in op de ellips-autovorm
        connector.setStartShapeConnectionSiteIndex(wantedIndex);
    }

    // Slaat de presentatie op
    pres.save("output.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Een connectorpunt aanpassen

Je kunt een bestaande connector aanpassen via zijn aanpassingspunten. Alleen connectoren met aanpassingspunten kunnen op deze manier worden gewijzigd. Zie de tabel onder Soorten connectoren

Eenvoudig geval

Bekijk een geval waarin een connector tussen twee vormen (A en B) door een derde vorm (C) loopt:

connector-obstruction

Presentation pres = new Presentation();
try {

    ISlide sld = pres.getSlides().get_Item(0);
    IShape shape = sld.getShapes().addAutoShape(ShapeType.Rectangle, 300, 150, 150, 75);
    IShape shapeFrom = sld.getShapes().addAutoShape(ShapeType.Rectangle, 500, 400, 100, 50);
    IShape shapeTo = sld.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 70, 30);

    IConnector 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(Color.BLACK);

    connector.setStartShapeConnectedTo(shapeFrom);
    connector.setEndShapeConnectedTo(shapeTo);
    connector.setStartShapeConnectionSiteIndex(2);
} finally {
    if (pres != null) pres.dispose();
}

Om de derde vorm te vermijden of te omzeilen, kunnen we de connector aanpassen door de verticale lijn naar links te verplaatsen:

connector-obstruction-fixed

IAdjustValue adj2 = connector.getAdjustments().get_Item(1);
adj2.setRawValue(adj2.getRawValue() + 10000);

Complexe gevallen

Om meer gecompliceerde aanpassingen uit te voeren, moet je rekening houden met de volgende zaken:

  • Het aanpasbare punt van een connector is sterk gekoppeld aan een formule die zijn positie berekent en bepaalt. Wijzigingen in de locatie van het punt kunnen de vorm van de connector beïnvloeden.
  • De aanpassingspunten van een connector worden in een strikte volgorde in een array gedefinieerd. De punten zijn genummerd vanaf het startpunt van de connector tot het eindpunt.
  • Waarden van aanpassingspunten geven een percentage weer van de breedte/hoogte van de connectorvorm.
    • De vorm wordt begrensd door de start‑ en eindpunten van de connector vermenigvuldigd met 1000.
    • Het eerste, tweede en derde punt geven respectievelijk het percentage van de breedte, het percentage van de hoogte en opnieuw het percentage van de breedte weer.
  • Voor de berekeningen die de coördinaten van de aanpassingspunten bepalen, moet je rekening houden met de rotatie en de spiegeling van de connector. Opmerking dat de rotatiehoek voor alle connectoren die onder Soorten connectoren worden getoond 0 is.

Geval 1

Beschouw een scenario waarbij twee tekstkaderobjecten via een connector met elkaar zijn verbonden:

connector-shape-complex

// Instantieert een presentatieklasse die een PPTX-bestand vertegenwoordigt
Presentation pres = new Presentation();
try {
    // Haalt de eerste dia van de presentatie op
    ISlide sld = pres.getSlides().get_Item(0);
    // Voegt vormen toe die via een connector met elkaar worden verbonden
    IAutoShape shapeFrom = sld.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 60, 25);
    shapeFrom.getTextFrame().setText("From");
    IAutoShape shapeTo = sld.getShapes().addAutoShape(ShapeType.Rectangle, 500, 100, 60, 25);
    shapeTo.getTextFrame().setText("To");
    // Voegt een connector toe
    IConnector connector = sld.getShapes().addConnector(ShapeType.BentConnector4, 20, 20, 400, 300);
    // Specificeert de richting van de connector
    connector.getLineFormat().setEndArrowheadStyle(LineArrowheadStyle.Triangle);
    // Specificeert de kleur van de connector
    connector.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    connector.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.RED);
    // Specificeert de dikte van de connectorlijn
    connector.getLineFormat().setWidth(3);
    
    // Verbindt de vormen met de connector
    connector.setStartShapeConnectedTo(shapeFrom);
    connector.setStartShapeConnectionSiteIndex(3);
    connector.setEndShapeConnectedTo(shapeTo);
    connector.setEndShapeConnectionSiteIndex(2);
    
    // Haalt de aanpassingspunten van de connector op
    IAdjustValue adjValue_0 = connector.getAdjustments().get_Item(0);
    IAdjustValue adjValue_1 = connector.getAdjustments().get_Item(1);

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

Aanpassing

We kunnen de waarden van de aanpassingspunten van de connector wijzigen door respectievelijk 20 % en 200 % van het overeenkomstige breedte‑ en hoogtepercentage te verhogen:

// Wijzigt de waarden van de aanpassingspunten
adjValue_0.setRawValue(adjValue_0.getRawValue() + 20000);
adjValue_1.setRawValue(adjValue_1.getRawValue() + 200000);

Het resultaat:

connector-adjusted-1

Om een model te definiëren waarmee we de coördinaten en vorm van individuele delen van de connector kunnen bepalen, maken we een vorm die overeenkomt met het horizontale component van de connector op het punt connector.getAdjustments().get_Item(0):

// Teken het verticale component van de connector
float x = connector.getX() + connector.getWidth() * adjValue_0.getRawValue() / 100000;
float y = connector.getY();
float height = connector.getHeight() * adjValue_1.getRawValue() / 100000;
sld.getShapes().addAutoShape( ShapeType .Rectangle, x, y, 0, height);

Het resultaat:

connector-adjusted-2

Geval 2

In Geval 1 hebben we een eenvoudige connector‑aanpassing getoond met basisprincipes. In normale situaties moet je de rotatie van de connector en de weergave ervan (die worden ingesteld via connector.getRotation(), connector.getFrame().getFlipH() en connector.getFrame().getFlipV()) in overweging nemen. We demonstreren nu het volledige proces.

Eerst voegen we een nieuw tekstkaderobject (To 1) toe aan de dia (voor verbindingsdoeleinden) en creëren we een nieuwe (groene) connector die het verbindt met de objecten die we al hebben gemaakt.

// Maakt een nieuw bindingobject
IAutoShape shapeTo_1 = sld.getShapes().addAutoShape(ShapeType.Rectangle, 100, 400, 60, 25);
shapeTo_1.getTextFrame().setText("To 1");
// Maakt een nieuwe connector
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(Color.CYAN);
connector.getLineFormat().setWidth(3);
// Verbindt objecten met de nieuw gemaakte connector
connector.setStartShapeConnectedTo(shapeFrom);
connector.setStartShapeConnectionSiteIndex(2);
connector.setEndShapeConnectedTo(shapeTo_1);
connector.setEndShapeConnectionSiteIndex(3);
// Haalt de aanpassingspunten van de connector op
adjValue_0 = connector.getAdjustments().get_Item(0);
adjValue_1 = connector.getAdjustments().get_Item(1);
// Wijzigt de waarden van de aanpassingspunten
adjValue_0.setRawValue(adjValue_0.getRawValue() + 20000);
adjValue_1.setRawValue(adjValue_1.getRawValue() + 200000);

Het resultaat:

connector-adjusted-3

Vervolgens maken we een vorm die overeenkomt met het horizontale component van de connector dat door het nieuwe aanpassingspunt connector.getAdjustments().get_Item(0) loopt. We gebruiken de waarden uit de connector‑data voor connector.getRotation(), connector.getFrame().getFlipH() en connector.getFrame().getFlipV() en passen de gangbare coördinatenomzettingsformule toe voor rotatie rond een gegeven punt x₀:

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

In ons geval bedraagt de rotatiehoek van het object 90 graden en wordt de connector verticaal weergegeven, dus dit is de bijbehorende code:

// Slaat de connectorcoördinaten op
x = connector.getX();
y = connector.getY();
// Corrigeert de connectorcoördinaten voor het geval deze verschijnt
if (connector.getFrame().getFlipH() == NullableBool.True)
{
    x += connector.getWidth();
}
if (connector.getFrame().getFlipV() == NullableBool.True)
{
    y += connector.getHeight();
}
// Neemt de waarde van het aanpassingspunt als coördinaat
x += connector.getWidth() * adjValue_0.getRawValue() / 100000;
//  Converteert de coördinaten aangezien Sin(90) = 1 en Cos(90) = 0
float xx = connector.getFrame().getCenterX() - y + connector.getFrame().getCenterY();
float yy = x - connector.getFrame().getCenterX() + connector.getFrame().getCenterY();
// Bepaalt de breedte van het horizontale component met gebruik van de tweede aanpassingspuntwaarde
float width = connector.getHeight() * adjValue_1.getRawValue() / 100000;
IAutoShape shape = sld.getShapes().addAutoShape(ShapeType.Rectangle, xx, yy, width, 0);
shape.getLineFormat().getFillFormat().setFillType(FillType.Solid);
shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.RED);

Het resultaat:

connector-adjusted-4

We hebben berekeningen getoond die zowel eenvoudige als ingewikkelde aanpassingspunten (met rotatiehoeken) omvatten. Met de opgedane kennis kun je je eigen model ontwikkelen (of code schrijven) om een GraphicsPath‑object te verkrijgen of zelfs de waarden van de aanpassingspunten van een connector in te stellen op basis van specifieke dia‑coördinaten.

De hoek van connectorlijnen bepalen

  1. Maak een instantie van de klasse.
  2. Haal de referentie van een dia op via de index.
  3. Verkrijg de vorm van de connectorlijn.
  4. Gebruik de breedte, hoogte, vorm‑frame‑hoogte en vorm‑frame‑breedte om de hoek te berekenen.

Deze Java‑code toont een bewerking waarin we de hoek van een connectorlijnvorm berekenen:

Presentation pres = new Presentation("ConnectorLineAngle.pptx");
try {
    Slide slide = (Slide)pres.getSlides().get_Item(0);
    
    for (int i = 0; i < slide.getShapes().size(); i++)
    {
        double dir = 0.0;
        Shape shape = (Shape)slide.getShapes().get_Item(i);
        if (shape instanceof AutoShape)
        {
            AutoShape ashp = (AutoShape)shape;
            if (ashp.getShapeType() == ShapeType.Line)
            {
                dir = getDirection(ashp.getWidth(), ashp.getHeight(),
                        ashp.getFrame().getFlipH() > 0, ashp.getFrame().getFlipV() > 0);
            }
        }
        else if (shape instanceof Connector)
        {
            Connector ashp = (Connector)shape;
            dir = getDirection(ashp.getWidth(), ashp.getHeight(),
                    ashp.getFrame().getFlipH() > 0, ashp.getFrame().getFlipV() > 0);
        }

        System.out.println(dir);
    }
} finally {
    if (pres != null) pres.dispose();
}

public static double getDirection(float w, float h, boolean flipH, boolean flipV)
{
    float endLineX = w * (flipH ? -1 : 1);
    float endLineY = h * (flipV ? -1 : 1);
    float endYAxisX = 0;
    float endYAxisY = h;
    double angle = (Math.atan2(endYAxisY, endYAxisX) - Math.atan2(endLineY, endLineX));
    if (angle < 0) angle += 2 * Math.PI;
    return angle * 180.0 / Math.PI;
}

Veelgestelde vragen

Hoe kan ik bepalen of een connector aan een specifieke vorm kan worden “geplakt”?

Controleer of de vorm connection sites beschikbaar stelt. Als er geen of nul sites zijn, is plakken niet mogelijk; gebruik in dat geval vrije eindpunten en positioneer ze handmatig. Het is verstandig de telling van sites te controleren voordat je verbindt.

Wat gebeurt er met een connector als ik een van de verbonden vormen verwijder?

De uiteinden worden losgekoppeld; de connector blijft op de dia als een gewone lijn met vrije start/eind. Je kunt de lijn verwijderen of de verbindingen opnieuw toewijzen en, indien nodig, reroute.

Blijven connectorbindingen behouden bij het kopiëren van een dia naar een andere presentatie?

Over het algemeen ja, mits de doelvormen ook worden gekopieerd. Als de dia in een ander bestand wordt ingevoegd zonder de verbonden vormen, worden de uiteinden vrij en moet je ze opnieuw koppelen.

Aangepaste presentatieshapes in Java