使用 Python 在簡報中管理連接線

簡介

PowerPoint 連接線是一種專門用來連結兩個圖形的線條，當圖形在投影片上移動或重新定位時，連接線會保持附著。連接線會附著在圖形的 連接點（綠點）上。當指標靠近連接點時會顯示。某些連接線提供 調整手柄（黃點），可讓您修改連接線的位置與形狀。

連接線類型

在 PowerPoint 中，您可以使用三種連接線：直線、彎角（斜角）與曲線。

Aspose.Slides 支援以下連接線類型：

連接線類型	圖片	調整點數量
`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

以連接線連結圖形

本節示範如何在 Aspose.Slides 中使用連接線連結圖形。您將在投影片中加入連接線，並將其起點與終點附著到目標圖形。使用連接點可確保即使圖形移動或調整大小，連接線仍保持「黏貼」狀態。

建立一個 Presentation 類別的執行個體。
依索引取得投影片的參考。
使用 ShapeCollection 物件的 add_auto_shape 方法，將兩個 AutoShape 加入投影片。
透過 ShapeCollection 物件的 add_connector 方法新增連接線，並指定連接線類型。
用連接線連結兩個圖形。
呼叫 reroute 方法以套用最短的連接路徑。
儲存投影片。

以下 Python 程式碼示範如何在兩個圖形（橢圓與矩形）之間加入彎曲連接線：

import aspose.slides as slides

# 初始化 Presentation 類別以建立 PPTX 檔案。
with slides.Presentation() as presentation:

    # 取得第一張投影片的 shapes 集合。
    shapes = presentation.slides[0].shapes

    # 新增橢圓 AutoShape。
    ellipse = shapes.add_auto_shape(slides.ShapeType.ELLIPSE, 50, 50, 100, 100)

    # 新增矩形 AutoShape。
    rectangle = shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 150, 200, 100, 100)

    # 在投影片上新增連接線。
    connector = shapes.add_connector(slides.ShapeType.BENT_CONNECTOR2, 0, 0, 10, 10)

    # 使用連接線將圖形連接起來。
    connector.start_shape_connected_to = ellipse
    connector.end_shape_connected_to = rectangle

    # 呼叫 reroute 設定最短路徑。
    connector.reroute()

    # 儲存簡報。
    presentation.save("connected_shapes.pptx", slides.export.SaveFormat.PPTX)

NOTE

connector.reroute 方法會重新導向連接線，強制其在圖形之間走最短路徑。為此，該方法可能會變更 start_shape_connection_site_index 與 end_shape_connection_site_index 的值。

指定連接點

本節說明如何在 Aspose.Slides 中將連接線附著到圖形的特定連接點。透過精準指定連接點，您可以控制連接線的路徑與版面配置，讓簡報中的圖表保持整潔且可預測。

建立一個 Presentation 類別的執行個體。
依索引取得投影片的參考。
使用 ShapeCollection 物件的 add_auto_shape 方法，將兩個 AutoShape 加入投影片。
透過 ShapeCollection 物件的 add_connector 方法新增連接線，並指定連接線類型。
用連接線連結兩個圖形。
在圖形上設定您偏好的連接點。
儲存投影片。

以下 Python 程式碼示範如何指定首選的連接點：

import aspose.slides as slides

# 初始化 Presentation 類別以建立 PPTX 檔案。
with slides.Presentation() as presentation:

    # 取得第一張投影片的 shapes 集合。
    shapes = presentation.slides[0].shapes

    # 新增橢圓 AutoShape。
    ellipse = shapes.add_auto_shape(slides.ShapeType.ELLIPSE, 50, 50, 100, 100)

    # 新增矩形 AutoShape。
    rectangle = shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 150, 200, 100, 100)

    # 在投影片的 shape 集合中新增連接線。
    connector = shapes.add_connector(slides.ShapeType.BENT_CONNECTOR3, 0, 0, 10, 10)

    # 使用連接線將圖形連接起來。
    connector.start_shape_connected_to = ellipse
    connector.end_shape_connected_to = rectangle

    # 設定橢圓的首選連接點索引。
    site_index = 6

    # 檢查首選索引是否在可用的連接點數量內。
    if  ellipse.connection_site_count > site_index:
        # 指定橢圓 AutoShape 上的首選連接點。
        connector.start_shape_connection_site_index = site_index

    # 儲存簡報。
    presentation.save("connection_points.pptx", slides.export.SaveFormat.PPTX)

調整連接點

您可以使用調整點來修改連接線。僅有公開調整點的連接線才能以此方式編輯。欲了解哪些連接線支援調整，請參考連接線類型表格。

簡單案例

考慮一條連接兩個圖形（A 與 B）的連接線與第三個圖形（C）相交的情況：

連接線阻礙

程式碼範例：

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

為避免與第三個圖形相交，將連接線的垂直段向左移動即可：

已修正的連接線阻礙

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

複雜案例

對於較高階的調整，請參考以下說明：

連接線的可調整點受一個公式控制，決定其位置。變更此點會改變整條連接線的形狀。
連接線的調整點以嚴格排序的陣列儲存，從起點到終點依序編號。
調整點值代表連接線形狀寬度/高度的百分比。
- 該形狀由連接線的起點與終點界定，並以 1000 為基準縮放。
- 第一、二、三個調整點分別代表：寬度百分比、高度百分比、再次的寬度百分比。
計算調整點座標時，需考慮連接線的旋轉與翻轉。**注意：**對於所有列於連接線類型的連接線，旋轉角度皆為 0。

案例 1

考慮兩個文字框物件以連接線相連的情形：

已連結的圖形

程式碼範例：

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

# 建立 Presentation 類別以建立 PPTX 檔案。
with slides.Presentation() as presentation:

    # 取得第一張投影片。
    slide = presentation.slides[0]

    # 取得第一張投影片。
    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"

    # 新增連接線。
    connector = slide.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.crimson
    # 設定連接線的線寬。
    connector.line_format.width = 3

    # 使用連接線將圖形連結。
    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

    # 取得連接線的調整點。
    adjustment_0 = connector.adjustments[0]
    adjustment_1 = connector.adjustments[1]

調整

將連接線的調整點值分別將寬度百分比提升 20%，高度百分比提升 200%：

    # 變更調整點的值。
    adjustment_0.raw_value += 20000
    adjustment_1.raw_value += 200000

結果：

連接線調整 1

為了建立一個模型，使我們能夠算出連接線各段的座標與形狀，請建立一個對應於 connector.adjustments[0] 的垂直元件的圖形：

    # 繪製連接線的垂直組件。
    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)

結果：

連接線調整 2

案例 2

在 案例 1 中，我們示範了使用基本原理進行簡單的連接線調整。實際情況下，必須同時考慮連接線的旋轉與顯示設定（由 connector.rotation、connector.frame.flip_h、connector.frame.flip_v 控制）。以下說明其運作方式。

首先，於投影片上新增一個文字框物件（To 1）作為連接點，並建立一條新的綠色連接線將其與既有物件相連：

    # 建立新的目標物件。
    shape_to_1 = sld.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 100, 400, 60, 25)
    shape_to_1.text_frame.text = "To 1"

    # 建立新的連接線。
    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

    # 使用新建立的連接線連接物件。
    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

    # 取得連接線的調整點。
    adjustment_0 = connector.adjustments[0]
    adjustment_1 = connector.adjustments[1]
    
    # 變更調整點的值。
    adjustment_0.raw_value += 20000
    adjustment_1.raw_value += 200000

結果：

連接線調整 3

其次，建立一個圖形對應於通過新連接線調整點 connector.adjustments[0] 的水平段。使用 connector.rotation、connector.frame.flip_h、connector.frame.flip_v 的值，套用繞固定點 x0 旋轉的座標轉換公式：

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

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

在本例中，物件的旋轉角度為 90 度，且連接線以垂直方式顯示，對應的程式碼如下：

    # 儲存連接線座標。
    x = connector.x
    y = connector.y
    
    # 如果連接線被翻轉，修正其座標。
    if connector.frame.flip_h == 1:
        x += connector.width
    if connector.frame.flip_v == 1:
        y += connector.height

    # 使用調整點的值作為座標。
    x += connector.width * adjValue_0.raw_value / 100000
    
    # 轉換座標，因為 sin(90°) = 1 且 cos(90°) = 0。
    xx = connector.frame.center_x - y + connector.frame.center_y
    yy = x - connector.frame.center_x + connector.frame.center_y

    # 使用第二個調整點的值決定水平段的寬度。
    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

結果：

連接線調整 4

我們示範了涉及簡單調整與更複雜（考慮旋轉）的調整點計算。掌握此知識後，您可以自行開發模型，或編寫程式碼取得 GraphicsPath 物件，甚至根據特定投影片座標設定連接線的調整點值。

取得連接線角度

使用以下範例可在 Aspose.Slides 中求得投影片上連接線的角度。您將學會讀取連接線的端點並計算其方向，從而精確對齊箭頭、標籤與其他圖形。

建立一個 Presentation 類別的執行個體。
依索引取得投影片的參考。
取得連接線形狀。
使用線條的寬度與高度，以及圖形框架的寬度與高度，計算角度。

以下 Python 程式碼示範如何計算連接線形狀的角度：

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)

常見問題

如何判斷連接線是否能「黏貼」到特定圖形？

請檢查該圖形是否公開 connection sites。如果沒有或計數為零，則無法黏貼；此時請使用自由端點並手動定位。建議在附著前先檢查 site 數量。

若我刪除其中一個已連接的圖形，連接線會怎樣？

其兩端會被分離，連接線會以普通線段的形式留在投影片上，擁有自由的起點與終點。您可以自行刪除，或重新指派連接，必要時再呼叫 reroute。

在將投影片複製到另一個簡報時，連接線的綁定會被保留嗎？

通常會保留，前提是目標圖形也一併被複製。如果投影片被插入到未包含連接圖形的檔案中，端點會變為自由狀態，需要重新附著。

使用 Python 自訂簡報中的圖形