Zarządzaj łącznikami w prezentacjach za pomocą Pythona

Wstęp

Łącznik PowerPoint to specjalna linia, która łączy dwa kształty i pozostaje przyczepiona, gdy kształty są przemieszczane lub zmieniane na slajdzie. Łączniki przyczepiają się do punktów połączenia (zielonych punktów) na kształtach. Punkty połączenia pojawiają się, gdy wskaźnik zbliża się do nich. Uchwyty regulacji (żółte punkty), dostępne w niektórych łącznikach, pozwalają modyfikować pozycję i kształt łącznika.

Typy Łączników

W programie PowerPoint można używać trzech typów łączników: prostego, łokciowego (z kątem) i zakrzywionego.

Aspose.Slides obsługuje następujące typy łączników:

Typ łącznika	Obraz	Liczba punktów regulacji
`ShapeType.LINE`		0
`ShapeType.STRAIGHT_CONNECTOR1`		0
`ShapeType.BENT_CONNECTOR2`		0
`ShapeType.BENT_CONNECTOR3`		1
`ShapeType.BENT_CONNECTOR4`		2
`ShapeType.BENT_CONNECTOR5`		3
`ShapeType.CURVED_CONNECTOR2`		0
`ShapeType.CURVED_CONNECTOR3`		1
`ShapeType.CURVED_CONNECTOR4`		2
`ShapeType.CURVED_CONNECTOR5`		3

Łączenie Kształtów za pomocą Łączników

Ta sekcja pokazuje, jak łączyć kształty za pomocą łączników w Aspose.Slides. Dodasz łącznik do slajdu, przyczepisz jego początek i koniec do docelowych kształtów. Użycie punktów połączenia zapewnia, że łącznik pozostaje „przyklejony” do kształtów, nawet gdy są one przemieszczane lub zmieniane.

Utwórz instancję klasy Presentation.
Uzyskaj odwołanie do slajdu za jego indeksem.
Dodaj dwa obiekty AutoShape do slajdu, używając metody add_auto_shape udostępnionej przez obiekt ShapeCollection.
Dodaj łącznik przy użyciu metody add_connector udostępnionej przez obiekt ShapeCollection, określając typ łącznika.
Połącz kształty za pomocą łącznika.
Wywołaj metodę reroute, aby zastosować najkrótszą ścieżkę połączenia.
Zapisz prezentację.

Poniższy kod w Pythonie pokazuje, jak dodać łamany łącznik między dwoma kształtami (elipsą i prostokątem):

import aspose.slides as slides

# Utwórz obiekt klasy Presentation, aby stworzyć plik PPTX.
with slides.Presentation() as presentation:

    # Uzyskaj dostęp do kolekcji kształtów pierwszego slajdu.
    shapes = presentation.slides[0].shapes

    # Dodaj AutoShape w kształcie elipsy.
    ellipse = shapes.add_auto_shape(slides.ShapeType.ELLIPSE, 50, 50, 100, 100)

    # Dodaj AutoShape w kształcie prostokąta.
    rectangle = shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 150, 200, 100, 100)

    # Dodaj łącznik do slajdu.
    connector = shapes.add_connector(slides.ShapeType.BENT_CONNECTOR2, 0, 0, 10, 10)

    # Połącz kształty przy użyciu łącznika.
    connector.start_shape_connected_to = ellipse
    connector.end_shape_connected_to = rectangle

    # Wywołaj reroute, aby ustawić najkrótszą ścieżkę.
    connector.reroute()

    # Zapisz prezentację.
    presentation.save("connected_shapes.pptx", slides.export.SaveFormat.PPTX)

NOTE

Metoda connector.reroute przerysowuje łącznik, zmuszając go do przyjęcia najkrótszej możliwej ścieżki między kształtami. W tym celu metoda może zmienić wartości start_shape_connection_site_index i end_shape_connection_site_index.

Określanie Punktów Połączenia

Ta sekcja wyjaśnia, jak przyczepić łącznik do konkretnego punktu połączenia na kształcie w Aspose.Slides. Kierując się precyzyjnie wybranymi punktami połączenia, możesz kontrolować trasę i układ łącznika, uzyskując czyste, przewidywalne diagramy w prezentacjach.

Utwórz instancję klasy Presentation.
Uzyskaj odwołanie do slajdu za jego indeksem.
Dodaj dwa obiekty AutoShape do slajdu, używając metody add_auto_shape udostępnionej przez obiekt ShapeCollection.
Dodaj łącznik przy użyciu metody add_connector na obiekcie ShapeCollection i określ typ łącznika.
Połącz kształty za pomocą łącznika.
Ustaw preferowane punkty połączenia na kształtach.
Zapisz prezentację.

Poniższy kod w Pythonie demonstruje, jak określić preferowany punkt połączenia:

import aspose.slides as slides

# Utwórz obiekt klasy Presentation, aby stworzyć plik PPTX.
with slides.Presentation() as presentation:

    # Uzyskaj dostęp do kolekcji kształtów pierwszego slajdu.
    shapes = presentation.slides[0].shapes

    # Dodaj AutoShape w kształcie elipsy.
    ellipse = shapes.add_auto_shape(slides.ShapeType.ELLIPSE, 50, 50, 100, 100)

    # Dodaj AutoShape w kształcie prostokąta.
    rectangle = shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 150, 200, 100, 100)

    # Dodaj łącznik do kolekcji kształtów slajdu.
    connector = shapes.add_connector(slides.ShapeType.BENT_CONNECTOR3, 0, 0, 10, 10)

    # Połącz kształty przy użyciu łącznika.
    connector.start_shape_connected_to = ellipse
    connector.end_shape_connected_to = rectangle

    # Ustaw preferowany indeks punktu połączenia na elipsie.
    site_index = 6

    # Sprawdź, czy preferowany indeks mieści się w dostępnej liczbie punktów połączenia.
    if  ellipse.connection_site_count > site_index:
        # Przypisz preferowany punkt połączenia do AutoShape elipsy.
        connector.start_shape_connection_site_index = site_index

    # Zapisz prezentację.
    presentation.save("connection_points.pptx", slides.export.SaveFormat.PPTX)

Regulacja Punktów Łącznika

Możesz modyfikować łączniki przy użyciu ich punktów regulacji. Tylko łączniki, które udostępniają punkty regulacji, mogą być w ten sposób edytowane. Szczegóły, które łączniki obsługują regulacje, znajdziesz w tabeli pod Typy Łączników.

Prosty Przypadek

Rozważmy przypadek, w którym łącznik między dwoma kształtami (A i B) przecina trzeci kształt (C):

Przeszkoda łącznika

Przykład kodu:

import aspose.slides as slides
import aspose.pydrawing as draw

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 300, 150, 150, 75)
    shape_from = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 500, 400, 100, 50)
    shape_to = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 100, 100, 70, 30)
    
    connector = slide.shapes.add_connector(slides.ShapeType.BENT_CONNECTOR5, 20, 20, 400, 300)
    
    connector.line_format.end_arrowhead_style = slides.LineArrowheadStyle.TRIANGLE
    connector.line_format.fill_format.fill_type = slides.FillType.SOLID
    connector.line_format.fill_format.solid_fill_color.color = draw.Color.black
    
    connector.start_shape_connected_to = shape_from
    connector.end_shape_connected_to = shape_to
    connector.start_shape_connection_site_index = 2

Aby ominąć trzeci kształt, wyreguluj łącznik, przesuwając jego pionowy odcinek w lewo:

Naprawiona przeszkoda łącznika

    adjustment2 = connector.adjustments[1]
    adjustment2.raw_value += 10000

Złożone Przypadki

Reguluowany punkt łącznika jest określany przez formułę wyznaczającą jego położenie. Zmiana tego punktu może zmienić ogólny kształt łącznika.
Punkty regulacji łącznika są przechowywane w ściśle uporządkowanej tablicy, numerowanej od początku łącznika do jego końca.
Wartości punktów regulacji reprezentują procenty szerokości/wysokości kształtu łącznika.
- Kształt jest ograniczony przez punkty początkowy i końcowy łącznika i skalowany przez 1000.
- Pierwszy, drugi i trzeci punkt regulacji oznaczają kolejno: procent szerokości, procent wysokości oraz ponownie procent szerokości.
Przy obliczaniu współrzędnych punktów regulacji uwzględnij rotację i odbicie łącznika. Uwaga: dla wszystkich łączników wymienionych w Typy Łączników kąt rotacji wynosi 0.

Przypadek 1

Rozważmy przypadek, w którym dwa obiekty ramki tekstowej są połączone łącznikiem:

Połączone kształty

import aspose.slides as slides
import aspose.pydrawing as draw

# Utwórz obiekt klasy Presentation, aby stworzyć plik PPTX.
with slides.Presentation() as presentation:

    # Uzyskaj pierwszy slajd.
    slide = presentation.slides[0]

    # Uzyskaj pierwszy slajd.
    shape_from = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 100, 100, 60, 25)
    shape_from.text_frame.text = "From"
    shape_to = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 500, 100, 60, 25)
    shape_to.text_frame.text = "To"

    # Dodaj łącznik.
    connector = slide.shapes.add_connector(slides.ShapeType.BENT_CONNECTOR4, 20, 20, 400, 300)
    # Ustaw kierunek łącznika.
    connector.line_format.end_arrowhead_style = slides.LineArrowheadStyle.TRIANGLE
    # Ustaw kolor łącznika.
    connector.line_format.fill_format.fill_type = slides.FillType.SOLID
    connector.line_format.fill_format.solid_fill_color.color = draw.Color.crimson
    # Ustaw grubość linii łącznika.
    connector.line_format.width = 3

    # Połącz kształty przy użyciu łącznika.
    connector.start_shape_connected_to = shape_from
    connector.start_shape_connection_site_index = 3
    connector.end_shape_connected_to = shape_to
    connector.end_shape_connection_site_index = 2

    # Pobierz punkty regulacji łącznika.
    adjustment_0 = connector.adjustments[0]
    adjustment_1 = connector.adjustments[1]

Regulacja

Zmień wartości punktów regulacji łącznika, zwiększając procent szerokości o 20 % oraz procent wysokości o 200 %:

    # Zmień wartości punktów regulacji.
    adjustment_0.raw_value += 20000
    adjustment_1.raw_value += 200000

Wynik:

Regulacja łącznika 1

Aby zdefiniować model umożliwiający wyznaczenie współrzędnych i kształtu odcinków łącznika, utwórz kształt odpowiadający pionowej części łącznika przy connector.adjustments[0]:

    # Narysuj pionowy składnik łącznika.
    x = connector.x + connector.width * adjustment_0.raw_value / 100000
    y = connector.y
    height = connector.height * adjustment_1.raw_value / 100000

    slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, x, y, 0, height)

Wynik:

Regulacja łącznika 2

Przypadek 2

W Przypadku 1 przedstawiliśmy prostą regulację łącznika, wykorzystując podstawowe zasady. W typowych scenariuszach musisz uwzględnić rotację łącznika oraz jego ustawienia wyświetlania (kontrolowane przez connector.rotation, connector.frame.flip_h i connector.frame.flip_v). Oto jak przebiega proces.

Najpierw dodaj nowy obiekt ramki tekstowej (To 1) do slajdu (w celu połączenia) i utwórz nowy zielony łącznik, który łączy go z istniejącymi obiektami.

    # Utwórz nowy obiekt docelowy.
    shape_to_1 = sld.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 100, 400, 60, 25)
    shape_to_1.text_frame.text = "To 1"

    # Utwórz nowy łącznik.
    connector = sld.shapes.add_connector(slides.ShapeType.BENT_CONNECTOR4, 20, 20, 400, 300)
    connector.line_format.end_arrowhead_style = slides.LineArrowheadStyle.TRIANGLE
    connector.line_format.fill_format.fill_type = slides.FillType.SOLID
    connector.line_format.fill_format.solid_fill_color.color = draw.Color.medium_aquamarine
    connector.line_format.width = 3

    # Połącz obiekty używając nowo utworzonego łącznika.
    connector.start_shape_connected_to = shapeFrom
    connector.start_shape_connection_site_index = 2
    connector.end_shape_connected_to = shape_to_1
    connector.end_shape_connection_site_index = 3

    # Pobierz punkty regulacji łącznika.
    adjustment_0 = connector.adjustments[0]
    adjustment_1 = connector.adjustments[1]
    
    # Zmień wartości punktów regulacji.
    adjustment_0.raw_value += 20000
    adjustment_1.raw_value += 200000

Wynik:

Regulacja łącznika 3

Następnie utwórz kształt odpowiadający poziomemu odcinkowi łącznika, który przechodzi przez nowy punkt regulacji łącznika connector.adjustments[0]. Skorzystaj z wartości connector.rotation, connector.frame.flip_h i connector.frame.flip_v oraz zastosuj standardową formułę przekształcenia współrzędnych dla obrotu wokół punktu x0:

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

W naszym przypadku kąt obrotu obiektu wynosi 90 stopni, a łącznik wyświetlany jest pionowo, więc odpowiedni kod to:

    # Zapisz współrzędne łącznika.
    x = connector.x
    y = connector.y
    
    # Skoryguj współrzędne łącznika, jeśli jest odwrócony.
    if connector.frame.flip_h == 1:
        x += connector.width
    if connector.frame.flip_v == 1:
        y += connector.height

    # Użyj wartości punktu regulacji jako współrzędnej.
    x += connector.width * adjValue_0.raw_value / 100000
    
    # Przekształć współrzędne, ponieważ sin(90°) = 1 i cos(90°) = 0.
    xx = connector.frame.center_x - y + connector.frame.center_y
    yy = x - connector.frame.center_x + connector.frame.center_y

    # Określ szerokość poziomego odcinka przy użyciu wartości drugiego punktu regulacji.
    width = connector.height * adjValue_1.raw_value / 100000
    shape = sld.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, xx, yy, width, 0)
    shape.line_format.fill_format.fill_type = slides.FillType.SOLID
    shape.line_format.fill_format.solid_fill_color.color = draw.Color.red

Wynik:

Regulacja łącznika 4

Zademonstrowaliśmy obliczenia obejmujące zarówno proste regulacje, jak i bardziej złożone punkty regulacji (uwzględniające rotację). Korzystając z tej wiedzy, możesz opracować własny model — lub napisać kod — aby uzyskać obiekt GraphicsPath albo nawet ustawić wartości punktów regulacji łącznika na podstawie konkretnych współrzędnych slajdu.

Znajdowanie Kątów Linii Łącznika

Użyj poniższego przykładu, aby określić kąt linii łącznika na slajdzie w Aspose.Slides. Dowiesz się, jak odczytać końcowe punkty łącznika i obliczyć jego orientację, aby precyzyjnie wyrównać strzałki, etykiety i inne kształty.

Utwórz instancję klasy Presentation.
Uzyskaj odwołanie do slajdu według indeksu.
Uzyskaj dostęp do kształtu linii łącznika.
Skorzystaj z szerokości i wysokości linii oraz szerokości i wysokości ramki kształtu, aby obliczyć kąt.

Poniższy kod w Pythonie pokazuje, jak obliczyć kąt dla kształtu linii łącznika:

import aspose.slides as slides
import math

def get_direction(w, h, flip_h, flip_v):
    end_line_x = w * (-1 if flip_h else 1)
    end_line_y = h * (-1 if flip_v else 1)
    end_y_axis_x = 0
    end_y_axis_y = h
    angle = math.atan2(end_y_axis_y, end_y_axis_x) - math.atan2(end_line_y, end_line_x)
    if (angle < 0):
         angle += 2 * math.pi
    return angle * 180.0 / math.pi

with slides.Presentation("connector_line_angle.pptx") as presentation:
    slide = presentation.slides[0]
    for shape_index in range(len(slide.shapes)):
        direction = 0.0
        shape = slide.shapes[shape_index]
        if type(shape) is slides.AutoShape and shape.shape_type == slides.ShapeType.LINE:
            direction = get_direction(shape.width, shape.height, shape.frame.flip_h, shape.frame.flip_v)
        elif type(shape) is slides.Connector:
            direction = get_direction(shape.width, shape.height, shape.frame.flip_h, shape.frame.flip_v)
        print(direction)

FAQ

Jak mogę sprawdzić, czy łącznik może być „przyklejony” do konkretnego kształtu?

Sprawdź, czy kształt udostępnia punkty połączenia. Jeśli ich nie ma lub liczba wynosi zero, przyklejenie nie jest dostępne; w takim wypadku użyj wolnych końcówek i ręcznie je pozycjonuj. Warto sprawdzić liczbę punktów przed przyczepieniem.

Co się stanie z łącznikiem, jeśli usunę jeden z połączonych kształtów?

Jego końce zostaną odłączone; łącznik pozostaje na slajdzie jako zwykła linia z wolnym początkiem i końcem. Możesz go usunąć lub ponownie przypisać połączenia i, w razie potrzeby, przeroutować.

Czy powiązania łączników są zachowywane przy kopiowaniu slajdu do innej prezentacji?

Zazwyczaj tak, pod warunkiem że skopiowane zostaną również docelowe kształty. Jeśli slajd zostanie wstawiony do innego pliku bez połączonych kształtów, końce staną się wolne i będzie trzeba je ponownie przyczepić.

Personalizuj kształty w prezentacjach za pomocą Pythona