Quản lý các nút hình SmartArt trong bản trình chiếu sử dụng Python

Trang này nói về điều gì

Quản lý các nút hình SmartArt trong PPT và PPTX bằng Aspose.Slides cho Python thông qua Java. Nhận các ví dụ mã rõ ràng và mẹo để tối ưu hóa bản trình chiếu của bạn.

Tổng quan

Đồ họa SmartArt trong các bản trình chiếu PowerPoint được tổ chức thông qua các nút chứa văn bản và xác định cấu trúc của sơ đồ. Aspose.Slides cho phép bạn làm việc với các nút SmartArt này một cách lập trình: thêm nút mới và nút con, chèn nút con vào vị trí cụ thể, truy cập các nút hiện có và đọc văn bản, cấp độ và vị trí của chúng.

Bài viết này giải thích cách quản lý các nút hình SmartArt. Nó chỉ ra cách xóa nút, làm việc với các nút con theo chỉ mục hoặc vị trí, chuyển một nút trợ lý thành nút thường, điều chỉnh vị trí, kích thước và góc quay của các hình nút SmartArt, đặt định dạng tô đầy cho nút, và tạo hình thu nhỏ cho một nút con của SmartArt.

Thêm một nút SmartArt

Aspose.Slides cho Python thông qua Java cung cấp API để quản lý các hình SmartArt. Ví dụ sau thêm một nút và một nút con vào hình SmartArt.

Tạo một thể hiện của lớp Presentation và tải bản trình chiếu chứa hình SmartArt.
Lấy slide đầu tiên theo chỉ mục của nó.
Duyệt qua mọi hình trên slide đầu tiên.
Kiểm tra xem hình có phải là một đối tượng SmartArt hay không.
Thêm một nút mới vào bộ sưu tập nút của hình SmartArt và đặt văn bản của nó thông qua TextFrame.
Thêm một nút con vào nút mới và đặt văn bản của nó thông qua TextFrame.
Lưu bản trình chiếu.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SmartArt

presentation = Presentation("SimpleSmartArt.pptx")
try:
    for shape in presentation.getSlides().get_Item(0).getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape
            node = smart_art.getAllNodes().addNode()
            node.getTextFrame().setText("Test")
            child_node = node.getChildNodes().addNode()
            child_node.getTextFrame().setText("New Node Added")
    presentation.save("AddSmartArtNode.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Thêm một nút SmartArt ở vị trí cụ thể

Ví dụ sau thêm một nút con vào vị trí cụ thể trong một nút SmartArt.

Tạo một thể hiện của lớp Presentation và tải bản trình chiếu chứa hình SmartArt.
Lấy slide đầu tiên theo chỉ mục của nó.
Thêm một hình SmartArt với bố cục StackedList vào slide.
Truy cập nút đầu tiên trong hình SmartArt vừa thêm.
Thêm một nút con vào nút đã chọn ở vị trí 2 bằng cách sử dụng addNodeByPosition và đặt văn bản cho nó.
Lưu bản trình chiếu.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SmartArtLayoutType

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    smart_art = slide.getShapes().addSmartArt(0, 0, 400, 400, SmartArtLayoutType.StackedList)
    node = smart_art.getAllNodes().get_Item(0)
    child_node = node.getChildNodes().addNodeByPosition(2)
    child_node.getTextFrame().setText("Sample Text Added")
    presentation.save("AddSmartArtNodeByPosition.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Truy cập một nút SmartArt

Ví dụ sau truy cập các nút trong một hình SmartArt. Bố cục trả về bởi getLayout là chỉ đọc và được thiết lập khi hình SmartArt được thêm vào.

Tạo một thể hiện của lớp Presentation và tải bản trình chiếu chứa hình SmartArt.
Lấy slide đầu tiên theo chỉ mục của nó.
Duyệt qua mọi hình trên slide đầu tiên.
Kiểm tra xem hình có phải là một đối tượng SmartArt hay không.
Duyệt qua tất cả các nút trong hình SmartArt.
Đọc và hiển thị vị trí, cấp độ và văn bản của mỗi nút SmartArt.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SmartArt

presentation = Presentation("SmartArtShape.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    for shape in slide.getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape
            for i in range(smart_art.getAllNodes().size()):
                node = smart_art.getAllNodes().get_Item(i)
                print(node.getTextFrame().getText(), " ", node.getLevel(), " ", node.getPosition())
finally:
    presentation.dispose()

Truy cập một nút con SmartArt

Ví dụ sau truy cập các nút con của mỗi nút trong một hình SmartArt.

Tạo một thể hiện của lớp Presentation và tải bản trình chiếu chứa hình SmartArt.
Lấy slide đầu tiên theo chỉ mục của nó.
Duyệt qua mọi hình trên slide đầu tiên.
Kiểm tra xem hình có phải là một đối tượng SmartArt hay không.
Duyệt qua tất cả các nút trong hình SmartArt.
Đối với mỗi nút, duyệt qua các nút con của nó.
Đọc và hiển thị vị trí, cấp độ và văn bản của nút con.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SmartArt

presentation = Presentation("AccessChildNodes.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    for shape in slide.getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape
            for i in range(smart_art.getAllNodes().size()):
                parent_node = smart_art.getAllNodes().get_Item(i)
                for j in range(parent_node.getChildNodes().size()):
                    node = parent_node.getChildNodes().get_Item(j)
                    print("j = ", j, ", Text = ", node.getTextFrame().getText(), ",  Level = ", node.getLevel(), ", Position = ", node.getPosition())
finally:
    presentation.dispose()

Truy cập một nút con SmartArt ở vị trí cụ thể

Ví dụ sau truy cập một nút con tại một chỉ mục cụ thể trong bộ sưu tập của nút cha.

Tạo một thể hiện của lớp Presentation và tải bản trình chiếu chứa hình SmartArt.
Lấy slide đầu tiên theo chỉ mục của nó.
Thêm một hình SmartArt với bố cục StackedList.
Truy cập hình SmartArt đã thêm.
Truy cập nút tại chỉ mục 0 trong hình SmartArt.
Truy cập nút con tại chỉ mục 1 bằng cách sử dụng get_Item.
Đọc và hiển thị vị trí, cấp độ và văn bản của nút con.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SmartArtLayoutType

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    smart_art = slide.getShapes().addSmartArt(0, 0, 400, 400, SmartArtLayoutType.StackedList)
    node = smart_art.getAllNodes().get_Item(0)
    position = 1
    child_node = node.getChildNodes().get_Item(position)
    print("Text = ", child_node.getTextFrame().getText(), ",  Level = ", child_node.getLevel(), ", Position = ", child_node.getPosition())
finally:
    presentation.dispose()

Xóa một nút SmartArt

Ví dụ sau xóa một nút khỏi hình SmartArt.

Tạo một thể hiện của lớp Presentation và tải bản trình chiếu chứa hình SmartArt.
Lấy slide đầu tiên theo chỉ mục của nó.
Duyệt qua mọi hình trên slide đầu tiên.
Kiểm tra xem hình có phải là một đối tượng SmartArt hay không.
Kiểm tra rằng hình SmartArt chứa ít nhất một nút.
Chọn nút SmartArt cần xóa.
Xóa nút đã chọn bằng cách sử dụng removeNode.
Lưu bản trình chiếu.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SmartArt

presentation = Presentation("AddSmartArtNode.pptx")
try:
    for shape in presentation.getSlides().get_Item(0).getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape
            if smart_art.getAllNodes().size() > 0:
                node = smart_art.getAllNodes().get_Item(0)
                smart_art.getAllNodes().removeNode(node)
    presentation.save("RemoveSmartArtNode.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Xóa một nút SmartArt từ vị trí cụ thể

Ví dụ sau xóa một nút con tại một chỉ mục cụ thể trong bộ sưu tập của một nút SmartArt.

Tạo một thể hiện của lớp Presentation và tải bản trình chiếu chứa hình SmartArt.
Lấy slide đầu tiên theo chỉ mục của nó.
Duyệt qua mọi hình trên slide đầu tiên.
Kiểm tra xem hình có phải là một đối tượng SmartArt hay không.
Truy cập nút SmartArt tại chỉ mục 0 nếu tồn tại.
Kiểm tra rằng nút SmartArt đã chọn có ít nhất hai nút con.
Xóa nút con tại chỉ mục 1 bằng cách sử dụng removeNode.
Lưu bản trình chiếu.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SmartArt

presentation = Presentation("AddSmartArtNode.pptx")
try:
    for shape in presentation.getSlides().get_Item(0).getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape
            if smart_art.getAllNodes().size() > 0:
                node = smart_art.getAllNodes().get_Item(0)
                if node.getChildNodes().size() >= 2:
                    node.getChildNodes().removeNode(1)
    presentation.save("RemoveSmartArtNodeByPosition.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Đặt vị trí tùy chỉnh cho nút con trong đối tượng SmartArt

Aspose.Slides cho Python thông qua Java hỗ trợ đặt vị trí của một SmartArtShape bằng cách sử dụng setX và setY. Ví dụ sau đặt vị trí, kích thước và góc quay tùy chỉnh cho các hình nút SmartArt. Thêm các nút mới sẽ tính lại vị trí và kích thước của mọi nút. Định vị tùy chỉnh cho phép bạn sắp xếp các nút theo yêu cầu.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SmartArtLayoutType

presentation = Presentation("SimpleSmartArt.pptx")
try:
    smart_art = presentation.getSlides().get_Item(0).getShapes().addSmartArt(20, 20, 600, 500, SmartArtLayoutType.OrganizationChart)
    node = smart_art.getAllNodes().get_Item(1)
    shape = node.getShapes().get_Item(1)
    shape.setX(shape.getX() + shape.getWidth() * 2)
    shape.setY(shape.getY() - shape.getHeight() * 2)
    node = smart_art.getAllNodes().get_Item(2)
    shape = node.getShapes().get_Item(1)
    shape.setWidth(shape.getWidth() + shape.getWidth() * 2)
    node = smart_art.getAllNodes().get_Item(3)
    shape = node.getShapes().get_Item(1)
    shape.setHeight(shape.getHeight() + shape.getHeight() * 2)
    node = smart_art.getAllNodes().get_Item(4)
    shape = node.getShapes().get_Item(1)
    shape.setRotation(90)
    presentation.save("SmartArt.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Kiểm tra nút trợ lý

Note

Phần này khám phá các hình SmartArt được thêm vào các slide trình chiếu một cách lập trình bằng cách sử dụng Aspose.Slides cho Python thông qua Java.

Hình SmartArt nguồn được sử dụng trong ví dụ này.


Hình: Hình SmartArt nguồn trên một slide

Ví dụ sau xác định các nút trợ lý trong bộ sưu tập nút SmartArt và chuyển chúng thành nút thường.

Tạo một thể hiện của lớp Presentation và tải bản trình chiếu chứa hình SmartArt.
Lấy slide đầu tiên theo chỉ mục của nó.
Duyệt qua mọi hình trên slide đầu tiên.
Kiểm tra xem hình có phải là một đối tượng SmartArt hay không.
Duyệt qua tất cả các nút trong hình SmartArt và kiểm tra xem chúng có phải là Assistant Nodes hay không.
Chuyển mỗi nút trợ lý thành nút thường.
Lưu bản trình chiếu.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SmartArt

presentation = Presentation("AddNodes.pptx")
try:
    for shape in presentation.getSlides().get_Item(0).getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape
            for i in range(smart_art.getAllNodes().size()):
                node = smart_art.getAllNodes().get_Item(i)
                if node.isAssistant():
                    node.setAssistant(False)
    presentation.save("ChangeAssistantNode.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()


Hình: Các nút trợ lý đã được chuyển đổi trong một hình SmartArt trên một slide

Đặt định dạng tô đầy cho nút

Aspose.Slides cho Python thông qua Java cho phép thêm các hình SmartArt tùy chỉnh và đặt định dạng tô đầy cho chúng. Bài viết này giải thích cách tạo và truy cập các hình SmartArt và đặt định dạng tô đầy cho chúng bằng cách sử dụng Aspose.Slides cho Python thông qua Java.

Vui lòng làm theo các bước dưới đây:

Tạo một thể hiện của lớp Presentation .
Lấy một slide theo chỉ mục của nó.
Thêm một SmartArt với bố cục ClosedChevronProcess .
Đặt FillFormat cho các nút của hình SmartArt.
Ghi bản trình chiếu đã chỉnh sửa dưới dạng tệp PPTX.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SmartArtLayoutType, FillType
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    chevron = slide.getShapes().addSmartArt(10, 10, 800, 60, SmartArtLayoutType.ClosedChevronProcess)
    node = chevron.getAllNodes().addNode()
    node.getTextFrame().setText("Some text")
    for item in node.getShapes():
        item.getFillFormat().setFillType(FillType.Solid)
        item.getFillFormat().getSolidFillColor().setColor(Color.RED)
    presentation.save("TestSmart.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Tạo hình thu nhỏ của nút con SmartArt

Để tạo hình thu nhỏ của một nút con SmartArt, thực hiện các bước sau:

Tạo một thể hiện của lớp Presentation .
Thêm một hình SmartArt .
Lấy một nút theo chỉ mục của nó.
Lấy hình ảnh thu nhỏ.
Lưu hình ảnh thu nhỏ ở bất kỳ định dạng hình ảnh nào mong muốn.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SmartArtLayoutType, ImageFormat

presentation = Presentation()
try:
    smart_art = presentation.getSlides().get_Item(0).getShapes().addSmartArt(10, 10, 400, 300, SmartArtLayoutType.BasicCycle)
    node = smart_art.getNodes().get_Item(1)
    image = node.getShapes().get_Item(0).getImage()
    try:
        image.save("SmartArt_ChildNode_Thumbnail.png", ImageFormat.Png)
    finally:
        image.dispose()
finally:
    presentation.dispose()

FAQ

Có hỗ trợ hoạt ảnh SmartArt không?

Có. SmartArt được xem như một hình dạng thông thường, vì vậy bạn có thể áp dụng các hoạt ảnh chuẩn (xuất hiện, biến mất, nhấn mạnh, đường chuyển động) và điều chỉnh thời gian. Bạn cũng có thể tạo hoạt ảnh cho các hình bên trong các nút SmartArt khi cần.

Làm thế nào để tôi có thể xác định đáng tin cậy một SmartArt cụ thể trên slide nếu ID nội bộ của nó không được biết?

Gán và tìm kiếm bằng văn bản thay thế. Việc đặt văn bản thay thế đặc trưng cho SmartArt cho phép bạn tìm nó một cách lập trình mà không phụ thuộc vào các định danh nội bộ.

Giao diện SmartArt có được bảo tồn khi chuyển đổi bản trình chiếu sang PDF không?

Có. Aspose.Slides render SmartArt với độ trung thực hình ảnh cao trong quá trình xuất PDF, bảo tồn bố cục, màu sắc và hiệu ứng.

Tôi có thể trích xuất hình ảnh của toàn bộ SmartArt (cho bản xem trước hoặc báo cáo) không?

Có. Bạn có thể render một hình SmartArt sang định dạng raster hoặc sang SVG để có đầu ra vector có thể mở rộng, phù hợp cho hình thu nhỏ, báo cáo hoặc sử dụng trên web.

Quản lý Đồ họa SmartArt trong Bản trình bày bằng Python