Quản lý các nút hình dạng SmartArt trong bản trình chiếu trên Android

Tổng quan

Đồ họa SmartArt trong các bản trình chiếu PowerPoint được tổ chức 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à các 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 dạng SmartArt. Nó cho thấy 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 nút hình dạng SmartArt, đặt định dạng đổ màu cho nút và tạo hình ảnh thu nhỏ cho một nút con SmartArt.

Thêm một Nút SmartArt

Aspose.Slides for Android via Java đã cung cấp API đơn giản nhất để quản lý các hình dạng SmartArt một cách dễ dàng. Mã mẫu sau sẽ giúp bạn thêm nút và nút con vào trong hình dạng SmartArt.

Tạo một thể hiện của lớp Presentation và tải bản trình chiếu có Đối tượng SmartArt.
Lấy tham chiếu của slide đầu tiên bằng cách sử dụng chỉ mục của nó.
Duyệt qua mọi hình dạng trong slide đầu tiên.
Kiểm tra xem hình dạng có phải là loại SmartArt không và chuyển đổi kiểu hình dạng đã chọn sang SmartArt nếu nó là SmartArt.
Thêm một Add a new Node vào hình dạng SmartArt NodeCollection và đặt văn bản trong TextFrame.
Bây giờ, Add một Child Node vào Node SmartArt mới thêm và đặt văn bản trong TextFrame.
Lưu bản trình chiếu.

// Tải bản trình chiếu mong muốn
Presentation pres = new Presentation("SimpleSmartArt.pptx");
try {
    // Duyệt qua mọi hình dạng trong slide đầu tiên
    for (IShape shape : pres.getSlides().get_Item(0).getShapes()) 
    {
        // Kiểm tra xem hình dạng có phải là loại SmartArt không
        if (shape instanceof SmartArt) 
        {
            // Ép kiểu hình dạng sang SmartArt
            SmartArt smart = (SmartArt) shape;
    
            // Thêm một nút SmartArt mới
            SmartArtNode TemNode = (SmartArtNode) smart.getAllNodes().addNode();
    
            // Thêm văn bản
            TemNode.getTextFrame().setText("Test");
    
            // Thêm nút con mới vào nút cha. Nó sẽ được thêm vào cuối bộ sưu tập
            SmartArtNode newNode = (SmartArtNode) TemNode.getChildNodes().addNode();
    
            // Thêm văn bản
            newNode.getTextFrame().setText("New Node Added");
        }
    }
    
    // Lưu bản trình chiếu
    pres.save("AddSmartArtNode.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Thêm một Nút SmartArt ở Vị trí Cụ thể

Trong đoạn mã mẫu sau chúng tôi giải thích cách thêm các nút con thuộc về các nút tương ứng của hình dạng SmartArt tại vị trí cụ thể.

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

// Tạo một thể hiện của bản trình chiếu
Presentation pres = new Presentation();
try {
    // Truy cập slide của bản trình chiếu
    ISlide slide = pres.getSlides().get_Item(0);

    // Thêm IShape SmartArt
    ISmartArt smart = slide.getShapes().addSmartArt(0, 0, 400, 400, SmartArtLayoutType.StackedList);

    // Truy cập nút SmartArt tại chỉ mục 0
    ISmartArtNode node = smart.getAllNodes().get_Item(0);

    // Thêm nút con mới tại vị trí 2 trong nút cha
    SmartArtNode chNode = (SmartArtNode) ((SmartArtNodeCollection) node.getChildNodes()).addNodeByPosition(2);

    // Thêm văn bản
    chNode.getTextFrame().setText("Sample Text Added");

    // Lưu bản trình chiếu
    pres.save("AddSmartArtNodeByPosition.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Truy cập một Nút SmartArt

Đoạn mã mẫu sau sẽ giúp bạn truy cập các nút bên trong hình dạng SmartArt. Lưu ý rằng bạn không thể thay đổi LayoutType của SmartArt vì nó chỉ đọc và chỉ được thiết lập khi hình dạng 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 có Đối tượng SmartArt.
Lấy tham chiếu của slide đầu tiên bằng cách sử dụng chỉ mục của nó.
Duyệt qua mọi hình dạng trong slide đầu tiên.
Kiểm tra xem hình dạng có phải là loại SmartArt không và chuyển đổi kiểu hình dạng đã chọn sang SmartArt nếu nó là SmartArt.
Duyệt qua tất cả Nodes trong SmartArt Shape.
Truy cập và hiển thị thông tin như vị trí, cấp độ và Văn bản của nút SmartArt.

// Tạo thể hiện của lớp Presentation
Presentation pres = new Presentation("SmartArtShape.pptx");
try {
    // Lấy slide đầu tiên
    ISlide slide = pres.getSlides().get_Item(0);
    
    // Duyệt qua mọi hình dạng trong slide đầu tiên
    for (IShape shape : slide.getShapes()) 
    {
        // Kiểm tra xem hình dạng có phải là loại SmartArt không
        if (shape instanceof ISmartArt) 
        {
            // Ép kiểu hình dạng sang SmartArt
            ISmartArt smart = (ISmartArt) shape;
    
            // Duyệt qua tất cả các nút trong SmartArt
            for (int i = 0; i < smart.getAllNodes().size(); i++) 
            {
                // Truy cập nút SmartArt tại chỉ mục i
                SmartArtNode node = (SmartArtNode) smart.getAllNodes().get_Item(i);
    
                // In các tham số của nút SmartArt
                System.out.print(node.getTextFrame().getText() + " " + node.getLevel() + " " + node.getPosition());
            }
        }
    }
} finally {
    if (pres != null) pres.dispose();
}

Truy cập một Nút Con SmartArt

Đoạn mã mẫu sau sẽ giúp bạn truy cập các nút con thuộc về các nút tương ứng của hình dạng SmartArt.

Tạo một thể hiện của lớp Presentation và tải bản trình chiếu có Đối tượng SmartArt.
Lấy tham chiếu của slide đầu tiên bằng cách sử dụng chỉ mục của nó.
Duyệt qua mọi hình dạng trong slide đầu tiên.
Kiểm tra xem hình dạng có phải là loại SmartArt không và chuyển đổi kiểu hình dạng đã chọn sang SmartArt nếu nó là SmartArt.
Duyệt qua tất cả Nodes trong SmartArt Shape.
Đối với mỗi Node đã chọn, duyệt qua tất cả Child Nodes trong nút cụ thể.
Truy cập và hiển thị thông tin như vị trí, cấp độ và Văn bản của Child Node.

// Tạo thể hiện của lớp Presentation
Presentation pres = new Presentation("AccessChildNodes.pptx");
try {
    // Lấy slide đầu tiên
    ISlide slide = pres.getSlides().get_Item(0);
    
    // Duyệt qua mọi hình dạng trong slide đầu tiên
    for (IShape shape : slide.getShapes()) 
    {
        // Kiểm tra xem hình dạng có phải là loại SmartArt không
        if (shape instanceof ISmartArt) 
        {
            // Ép kiểu hình dạng sang SmartArt
            ISmartArt smart = (ISmartArt) shape;
    
            // Duyệt qua tất cả các nút trong SmartArt
            for (int i = 0; i < smart.getAllNodes().size(); i++) 
            {
                // Truy cập nút SmartArt tại chỉ mục i
                SmartArtNode node0 = (SmartArtNode) smart.getAllNodes().get_Item(i);
                
                // Duyệt qua các nút con trong nút SmartArt tại chỉ mục i
                for (int j = 0; j < node0.getChildNodes().size(); j++) 
                {
                    // Truy cập nút con trong nút SmartArt
                    SmartArtNode node = (SmartArtNode) node0.getChildNodes().get_Item(j);
    
                    // In các tham số của nút con SmartArt
                    System.out.print("j = " + j + ", Text = " + node.getTextFrame().getText() + ",  Level = " + node.getLevel() + ", Position = " + node.getPosition());
                }
            }
        }
    }
} finally {
    if (pres != null) pres.dispose();
}

Truy cập Nút Con SmartArt tại Vị trí Cụ thể

Trong ví dụ này, chúng ta sẽ học cách truy cập các nút con ở một số vị trí cụ thể thuộc về các nút tương ứng của hình dạng SmartArt.

Tạo một thể hiện của lớp Presentation.
Lấy tham chiếu của slide đầu tiên bằng cách sử dụng chỉ mục của nó.
Thêm một hình dạng SmartArt loại StackedList.
Truy cập hình dạng SmartArt đã thêm.
Truy cập nút có chỉ mục 0 cho SmartArt shape đã truy cập.
Bây giờ, truy cập Child Node ở vị trí 1 cho nút SmartArt đã truy cập bằng phương thức get_Item().
Truy cập và hiển thị thông tin như vị trí, cấp độ và Văn bản của Child Node.

// Tạo thể hiện của bản trình chiếu
Presentation pres = new Presentation();
try {
    // Truy cập slide đầu tiên
    ISlide slide = pres.getSlides().get_Item(0);
    
    // Thêm hình dạng SmartArt vào slide đầu tiên
    ISmartArt smart = slide.getShapes().addSmartArt(0, 0, 400, 400, SmartArtLayoutType.StackedList);
    
    // Truy cập nút SmartArt tại chỉ mục 0
    ISmartArtNode node = smart.getAllNodes().get_Item(0);
    
    // Truy cập nút con tại vị trí 1 trong nút cha
    int position = 1;
    SmartArtNode chNode = (SmartArtNode) ((SmartArtNodeCollection) node.getChildNodes()).get_Item(position);
    
    // In các tham số của nút con SmartArt
    System.out.print("Text = " + chNode.getTextFrame().getText() + ",  Level = " + chNode.getLevel() + ", Position = " + chNode.getPosition());
} finally {
    if (pres != null) pres.dispose();
}

Xóa một Nút SmartArt

Trong ví dụ này, chúng ta sẽ học cách xóa các nút bên trong hình dạng SmartArt.

Tạo một thể hiện của lớp Presentation và tải bản trình chiếu có Đối tượng SmartArt.
Lấy tham chiếu của slide đầu tiên bằng cách sử dụng chỉ mục của nó.
Duyệt qua mọi hình dạng trong slide đầu tiên.
Kiểm tra xem hình dạng có phải là loại SmartArt không và chuyển đổi kiểu hình dạng đã chọn sang SmartArt nếu nó là SmartArt.
Kiểm tra xem SmartArt có nhiều hơn 0 nút hay không.
Chọn nút SmartArt cần xóa.
Bây giờ, xóa nút đã chọn bằng phương thức RemoveNode.
Lưu bản trình chiếu.

// Tải bản trình chiếu mong muốn
Presentation pres = new Presentation("AddSmartArtNode.pptx");
try {
    // Duyệt qua mọi hình dạng trong slide đầu tiên
    for (IShape shape : pres.getSlides().get_Item(0).getShapes()) 
    {
        // Kiểm tra xem hình dạng có phải là loại SmartArt không
        if (shape instanceof ISmartArt) 
        {
            // Ép kiểu hình dạng sang SmartArt
            ISmartArt smart = (ISmartArt) shape;
    
            if (smart.getAllNodes().size() > 0) 
            {
                // Truy cập nút SmartArt tại chỉ mục 0
                ISmartArtNode node = smart.getAllNodes().get_Item(0);
    
                // Xóa nút đã chọn
                smart.getAllNodes().removeNode(node);
            }
        }
    }
    
    // Lưu bản trình chiếu
    pres.save("RemoveSmartArtNode.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Xóa một Nút SmartArt tại Vị trí Cụ thể

Trong ví dụ này, chúng ta sẽ học cách xóa các nút bên trong hình dạng SmartArt tại vị trí cụ thể.

Tạo một thể hiện của lớp Presentation và tải bản trình chiếu có Đối tượng SmartArt.
Lấy tham chiếu của slide đầu tiên bằng cách sử dụng chỉ mục của nó.
Duyệt qua mọi hình dạng trong slide đầu tiên.
Kiểm tra xem hình dạng có phải là loại SmartArt không và chuyển đổi kiểu hình dạng đã chọn sang SmartArt nếu nó là SmartArt.
Chọn nút hình dạng SmartArt ở chỉ mục 0.
Bây giờ, kiểm tra xem nút SmartArt đã chọn có nhiều hơn 2 nút con hay không.
Bây giờ, xóa nút ở Vị trí 1 bằng phương thức RemoveNode.
Lưu bản trình chiếu.

// Tải bản trình chiếu mong muốn
Presentation pres = new Presentation("AddSmartArtNode.pptx");
try {
    // Duyệt qua mọi hình dạng trong slide đầu tiên
    for (IShape shape : pres.getSlides().get_Item(0).getShapes()) 
    {
        // Kiểm tra xem hình dạng có phải là loại SmartArt không
        if (shape instanceof SmartArt) 
        {
            // Ép kiểu hình dạng sang SmartArt
            SmartArt smart = (SmartArt) shape;
    
            if (smart.getAllNodes().size() > 0) 
            {
                // Truy cập nút SmartArt tại chỉ mục 0
                ISmartArtNode node = smart.getAllNodes().get_Item(0);
    
                if (node.getChildNodes().size() >= 2) 
                {
                    // Xóa nút con tại vị trí 1
                    (node.getChildNodes()).removeNode(1);
                }
            }
        }
    }
    
    // Lưu bản trình chiếu
    pres.save("RemoveSmartArtNodeByPosition.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Đặt Vị trí Tùy chỉnh cho Nút Con trong Đối tượng SmartArt

Hiện Aspose.Slides for Android via Java hỗ trợ việc thiết lập các thuộc tính SmartArtShape X và Y. Đoạn mã dưới đây cho thấy cách đặt vị trí, kích thước và góc quay tùy chỉnh cho SmartArtShape; cũng lưu ý rằng việc thêm nút mới sẽ làm tính lại vị trí và kích thước của tất cả các nút. Với cài đặt vị trí tùy chỉnh, người dùng có thể đặt các nút theo yêu cầu.

// Tạo thể hiện của lớp Presentation
Presentation pres = new Presentation("SimpleSmartArt.pptx");
try{
    ISmartArt smart = pres.getSlides().get_Item(0).getShapes().addSmartArt(20, 20, 600, 500, SmartArtLayoutType.OrganizationChart);

    // Di chuyển hình dạng SmartArt đến vị trí mới
    ISmartArtNode node = smart.getAllNodes().get_Item(1);
    ISmartArtShape shape = node.getShapes().get_Item(1);
    shape.setX(shape.getX() + shape.getWidth() * 2);
    shape.setY(shape.getY() - shape.getHeight() * 2);

    // Thay đổi chiều rộng của hình dạng SmartArt
    node = smart.getAllNodes().get_Item(2);
    shape = node.getShapes().get_Item(1);
    shape.setWidth(shape.getWidth() + shape.getWidth() * 2);

    // Thay đổi chiều cao của hình dạng SmartArt
    node = smart.getAllNodes().get_Item(3);
    shape = node.getShapes().get_Item(1);
    shape.setHeight(shape.getHeight() + shape.getHeight() * 2);

    // Thay đổi góc quay của hình dạng SmartArt
    node = smart.getAllNodes().get_Item(4);
    shape = node.getShapes().get_Item(1);
    shape.setRotation(90);

    pres.save("SmartArt.pptx", SaveFormat.Pptx);
}finally {
    pres.dispose();
}

Kiểm tra Nút Trợ lý

Trong bài viết này chúng tôi sẽ tiếp tục khám phá các tính năng của các hình dạng SmartArt được thêm vào các slide trình chiếu một cách lập trình bằng Aspose.Slides for Android via Java.

Chúng tôi sẽ sử dụng hình dạng SmartArt nguồn dưới đây cho các phần thí nghiệm trong bài viết.


Hình: Đối tượng SmartArt nguồn trong slide

Trong đoạn mã mẫu sau chúng tôi sẽ khảo sát cách xác định Assistant Nodes trong bộ sưu tập các nút SmartArt và thay đổi chúng.

Tạo một thể hiện của lớp Presentation và tải bản trình chiếu có Đối tượng SmartArt.
Lấy tham chiếu của slide thứ hai bằng cách sử dụng chỉ mục của nó.
Duyệt qua mọi hình dạng trong slide đầu tiên.
Kiểm tra xem hình dạng có phải là loại SmartArt không và chuyển đổi kiểu hình dạng đã chọn sang SmartArt nếu nó là SmartArt.
Duyệt qua tất cả các nút trong hình dạng SmartArt và kiểm tra xem chúng có phải là Assistant Nodes không.
Thay đổi trạng thái của Nút Trợ lý thành nút thường.
Lưu bản trình chiếu.

// Tạo một thể hiện của bản trình chiếu
Presentation pres = new Presentation("AddNodes.pptx");
try {
    // Duyệt qua mọi hình dạng trong slide đầu tiên
    for (IShape shape : pres.getSlides().get_Item(0).getShapes()) 
    {
        // Kiểm tra xem hình dạng có phải là loại SmartArt không
        if (shape instanceof ISmartArt) 
        {
            // Ép kiểu hình dạng sang SmartArt
            ISmartArt smart = (SmartArt) shape;
    
            // Duyệt qua tất cả các nút của hình dạng SmartArt
            for (int i = 0; i < smart.getAllNodes().size(); i++) 
            {
                ISmartArtNode node = smart.getAllNodes().get_Item(i);
                // Kiểm tra xem nút có phải là nút Trợ lý không
                if (node.isAssistant()) 
                {
                    // Đặt nút Trợ lý thành false và chuyển nó thành nút thường
                    node.isAssistant();
                }
            }
        }
    }
    
    // Lưu bản trình chiếu
    pres.save("ChangeAssitantNode.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}


Hình: Nút Trợ lý Được thay đổi trong SmartArt shape trong slide

Đặt Định dạng Đổ màu cho Nút

Aspose.Slides for Android via Java cho phép thêm các hình dạng SmartArt tùy chỉnh và đặt định dạng đổ màu 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 dạng SmartArt và đặt định dạng đổ màu cho chúng bằng Aspose.Slides for Android via Java.

Vui lòng thực hiện các bước sau:

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

// Tạo thể hiện của bản trình chiếu
Presentation pres = new Presentation();
try {
    // Truy cập slide
    ISlide slide = pres.getSlides().get_Item(0);
    
    // Thêm hình dạng SmartArt và các nút
    ISmartArt chevron = slide.getShapes().addSmartArt(10, 10, 800, 60, SmartArtLayoutType.ClosedChevronProcess);
    ISmartArtNode node = chevron.getAllNodes().addNode();
    node.getTextFrame().setText("Some text");
    
    // Đặt màu nền cho nút
    for (IShape item : node.getShapes()) 
    {
        item.getFillFormat().setFillType(FillType.Solid);
        item.getFillFormat().getSolidFillColor().setColor(Color.RED);
    }
    
    // Lưu bản trình chiếu
    pres.save("TestSmart.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Tạo Thumbnail cho Nút Con SmartArt

Các nhà phát triển có thể tạo thumbnail cho nút con của SmartArt bằng cách thực hiện các bước sau:

Tạo một thể hiện của lớp Presentation.
Add SmartArt.
Lấy tham chiếu của một nút bằng cách sử dụng chỉ mục của nó.
Lấy hình ảnh thumbnail.
Lưu hình ảnh thumbnail ở bất kỳ định dạng hình ảnh nào mong muốn.

// Tạo thể hiện của lớp Presentation đại diện cho tệp PPTX 
Presentation pres = new Presentation();
try {
    // Thêm SmartArt 
    ISmartArt smart = pres.getSlides().get_Item(0).getShapes().addSmartArt(10, 10, 400, 300, SmartArtLayoutType.BasicCycle);

    // Lấy tham chiếu của một nút bằng cách sử dụng chỉ mục của nó  
    ISmartArtNode node = smart.getNodes().get_Item(1);

    // Lấy hình thu nhỏ
    IImage slideImage = node.getShapes().get_Item(0).getImage();

    // Lưu hình thu nhỏ
    try {
          slideImage.save("SmartArt_ChildNote_Thumbnail.png", ImageFormat.Png);
    } finally {
         if (slideImage != null) slideImage.dispose();
    }
} finally {
    if (pres != null) pres.dispose();
}

Câu hỏi thường gặp

SmartArt animation có được hỗ trợ không?

Có. SmartArt được xử lý như một hình dạng thông thường, vì vậy bạn có thể apply standard animations (nhập, thoá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 dạng bên trong các nút SmartArt khi cần.

Làm sao tôi có thể xác định 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 alternative text. Thiết lập một AltText đặc trưng cho SmartArt giúp bạn tìm thấy nó một cách lập trình mà không cần dựa vào các định danh nội bộ.

Hình dáng SmartArt có được giữ nguyê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 PDF export, giữ nguyê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 dạng SmartArt ra raster formats hoặc ra SVG để có đầu ra vector có khả năng mở rộng, phù hợp cho thumbnail, báo cáo hoặc sử dụng trên web.

Quản lý Đồ họa SmartArt trong Bản trình chiếu trên Android