Gerenciar nós de forma SmartArt em apresentações no Android

Visão geral

Os gráficos SmartArt em apresentações do PowerPoint são organizados por meio de nós que contêm texto e definem a estrutura do diagrama. Aspose.Slides permite que você trabalhe com esses nós SmartArt programaticamente: adicionar novos nós e nós filhos, inserir nós filhos em uma posição específica, acessar nós existentes e ler seu texto, nível e posição.

Este artigo explica como gerenciar nós de formas SmartArt. Ele mostra como remover nós, trabalhar com nós filhos por índice ou posição, mudar um nó assistente para um nó normal, ajustar a posição, o tamanho e a rotação das formas dos nós SmartArt, definir formatos de preenchimento dos nós e gerar uma imagem em miniatura para um nó filho SmartArt.

Adicionar um nó SmartArt

Aspose.Slides para Android via Java oferece a API mais simples para gerenciar as formas SmartArt da maneira mais fácil. O código de exemplo a seguir ajudará a adicionar nó e nó filho dentro de uma forma SmartArt.

  1. Crie uma instância da classe Presentation e carregue a apresentação com a forma SmartArt.
  2. Obtenha a referência do primeiro slide usando seu Índice.
  3. Percorra todas as formas dentro do primeiro slide.
  4. Verifique se a forma é do tipo SmartArt e faça cast da forma selecionada para SmartArt se for SmartArt.
  5. Adicione um novo Node na forma SmartArt NodeCollection e defina o texto no TextFrame.
  6. Agora, Adicione um Child Node ao Node SmartArt recém‑adicionado e defina o texto no TextFrame.
  7. Salve a apresentação.
// Carregar a apresentação desejada
Presentation pres = new Presentation("SimpleSmartArt.pptx");
try {
    // Percorrer todas as formas dentro do primeiro slide
    for (IShape shape : pres.getSlides().get_Item(0).getShapes()) 
    {
        // Verificar se a forma é do tipo SmartArt
        if (shape instanceof SmartArt) 
        {
            // Fazer cast da forma para SmartArt
            SmartArt smart = (SmartArt) shape;
    
            // Adicionar um novo nó SmartArt
            SmartArtNode TemNode = (SmartArtNode) smart.getAllNodes().addNode();
    
            // Adicionar texto
            TemNode.getTextFrame().setText("Test");
    
            // Adicionar novo nó filho no nó pai. Será adicionado no final da coleção
            SmartArtNode newNode = (SmartArtNode) TemNode.getChildNodes().addNode();
    
            // Adicionar texto
            newNode.getTextFrame().setText("New Node Added");
        }
    }
    
    // Salvar apresentação
    pres.save("AddSmartArtNode.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Adicionar um nó SmartArt em uma posição específica

No código de exemplo a seguir explicamos como adicionar os nós filhos pertencentes aos respectivos nós da forma SmartArt em uma posição particular.

  1. Crie uma instância da classe Presentation.
  2. Obtenha a referência do primeiro slide usando seu Índice.
  3. Adicione uma forma StackedList do tipo SmartArt no slide acessado.
  4. Acesse o primeiro nó na forma SmartArt adicionada.
  5. Agora, adicione o Child Node para o Node selecionado na posição 2 e defina seu texto.
  6. Salve a apresentação.
// Criando uma instância de apresentação
Presentation pres = new Presentation();
try {
    // Acessar o slide da apresentação
    ISlide slide = pres.getSlides().get_Item(0);

    // Adicionar Smart Art IShape
    ISmartArt smart = slide.getShapes().addSmartArt(0, 0, 400, 400, SmartArtLayoutType.StackedList);

    // Acessando o nó SmartArt no índice 0
    ISmartArtNode node = smart.getAllNodes().get_Item(0);

    // Adicionando novo nó filho na posição 2 no nó pai
    SmartArtNode chNode = (SmartArtNode) ((SmartArtNodeCollection) node.getChildNodes()).addNodeByPosition(2);

    // Adicionar texto
    chNode.getTextFrame().setText("Sample Text Added");

    // Salvar apresentação
    pres.save("AddSmartArtNodeByPosition.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Acessar um nó SmartArt

O código de exemplo a seguir ajudará a acessar nós dentro da forma SmartArt. Observe que você não pode alterar o LayoutType do SmartArt, pois ele é somente leitura e é definido apenas quando a forma SmartArt é adicionada.

  1. Crie uma instância da classe Presentation e carregue a apresentação com a forma SmartArt.
  2. Obtenha a referência do primeiro slide usando seu Índice.
  3. Percorra todas as formas dentro do primeiro slide.
  4. Verifique se a forma é do tipo SmartArt e faça cast da forma selecionada para SmartArt se for SmartArt.
  5. Percorra todos os Nodes dentro da forma SmartArt.
  6. Acesse e exiba informações como posição do nó SmartArt, nível e Texto.
// Instanciar a classe Presentation
Presentation pres = new Presentation("SmartArtShape.pptx");
try {
    // Obter o primeiro slide
    ISlide slide = pres.getSlides().get_Item(0);
    
    // Percorrer todas as formas dentro do primeiro slide
    for (IShape shape : slide.getShapes()) 
    {
        // Verificar se a forma é do tipo SmartArt
        if (shape instanceof ISmartArt) 
        {
            // Fazer cast da forma para SmartArt
            ISmartArt smart = (ISmartArt) shape;
    
            // Percorrer todos os nós dentro do SmartArt
            for (int i = 0; i < smart.getAllNodes().size(); i++) 
            {
                // Acessando o nó SmartArt no índice i
                SmartArtNode node = (SmartArtNode) smart.getAllNodes().get_Item(i);
    
                // Imprimindo os parâmetros do nó SmartArt
                System.out.print(node.getTextFrame().getText() + " " + node.getLevel() + " " + node.getPosition());
            }
        }
    }
} finally {
    if (pres != null) pres.dispose();
}

Acessar um nó filho SmartArt

O código de exemplo a seguir ajudará a acessar os nós filhos pertencentes aos respectivos nós da forma SmartArt.

  1. Crie uma instância da classe Presentation e carregue a apresentação com a forma SmartArt.
  2. Obtenha a referência do primeiro slide usando seu Índice.
  3. Percorra todas as formas dentro do primeiro slide.
  4. Verifique se a forma é do tipo SmartArt e faça cast da forma selecionada para SmartArt se for SmartArt.
  5. Percorra todos os Nodes dentro da forma SmartArt.
  6. Para cada Node da forma SmartArt selecionada, percorra todos os Child Nodes dentro do nó particular.
  7. Acesse e exiba informações como posição, nível e Texto do Child Node.
// Instanciar a classe Presentation
Presentation pres = new Presentation("AccessChildNodes.pptx");
try {
    // Obter o primeiro slide
    ISlide slide = pres.getSlides().get_Item(0);
    
    // Percorrer todas as formas dentro do primeiro slide
    for (IShape shape : slide.getShapes()) 
    {
        // Verificar se a forma é do tipo SmartArt
        if (shape instanceof ISmartArt) 
        {
            // Fazer cast da forma para SmartArt
            ISmartArt smart = (ISmartArt) shape;
    
            // Percorrer todos os nós dentro do SmartArt
            for (int i = 0; i < smart.getAllNodes().size(); i++) 
            {
                // Acessando o nó SmartArt no índice i
                SmartArtNode node0 = (SmartArtNode) smart.getAllNodes().get_Item(i);
                
                // Percorrendo os nós filho no nó SmartArt no índice i
                for (int j = 0; j < node0.getChildNodes().size(); j++) 
                {
                    // Acessando o nó filho no nó SmartArt
                    SmartArtNode node = (SmartArtNode) node0.getChildNodes().get_Item(j);
    
                    // Imprimindo os parâmetros do nó filho SmartArt
                    System.out.print("j = " + j + ", Text = " + node.getTextFrame().getText() + ",  Level = " + node.getLevel() + ", Position = " + node.getPosition());
                }
            }
        }
    }
} finally {
    if (pres != null) pres.dispose();
}

Acessar um nó filho SmartArt em uma posição específica

Neste exemplo, aprenderemos a acessar os nós filhos em posições específicas pertencentes aos respectivos nós da forma SmartArt.

  1. Crie uma instância da classe Presentation.
  2. Obtenha a referência do primeiro slide usando seu Índice.
  3. Adicione uma forma SmartArt do tipo StackedList.
  4. Acesse a forma SmartArt adicionada.
  5. Acesse o nó no índice 0 da forma SmartArt acessada.
  6. Agora, acesse o Child Node na posição 1 do nó SmartArt acessado usando o método get_Item().
  7. Acesse e exiba informações como posição, nível e Texto do Child Node.
// Instanciar a apresentação
Presentation pres = new Presentation();
try {
    // Acessando o primeiro slide
    ISlide slide = pres.getSlides().get_Item(0);
    
    // Adicionando a forma SmartArt no primeiro slide
    ISmartArt smart = slide.getShapes().addSmartArt(0, 0, 400, 400, SmartArtLayoutType.StackedList);
    
    // Acessando o nó SmartArt no índice 0
    ISmartArtNode node = smart.getAllNodes().get_Item(0);
    
    // Acessando o nó filho na posição 1 no nó pai
    int position = 1;
    SmartArtNode chNode = (SmartArtNode) ((SmartArtNodeCollection) node.getChildNodes()).get_Item(position);
    
    // Imprimindo os parâmetros do nó filho SmartArt
    System.out.print("Text = " + chNode.getTextFrame().getText() + ",  Level = " + chNode.getLevel() + ", Position = " + chNode.getPosition());
} finally {
    if (pres != null) pres.dispose();
}

Remover um nó SmartArt

Neste exemplo, aprenderemos a remover os nós dentro da forma SmartArt.

  1. Crie uma instância da classe Presentation e carregue a apresentação com a forma SmartArt.
  2. Obtenha a referência do primeiro slide usando seu Índice.
  3. Percorra todas as formas dentro do primeiro slide.
  4. Verifique se a forma é do tipo SmartArt e faça cast da forma selecionada para SmartArt se for SmartArt.
  5. Verifique se o SmartArt tem mais de 0 nós.
  6. Selecione o nó SmartArt que será excluído.
  7. Agora, remova o nó selecionado usando o método RemoveNode .
  8. Salve a apresentação.
// Carregar a apresentação desejada
Presentation pres = new Presentation("AddSmartArtNode.pptx");
try {
    // Percorrer todas as formas dentro do primeiro slide
    for (IShape shape : pres.getSlides().get_Item(0).getShapes()) 
    {
        // Verificar se a forma é do tipo SmartArt
        if (shape instanceof ISmartArt) 
        {
            // Fazer cast da forma para SmartArt
            ISmartArt smart = (ISmartArt) shape;
    
            if (smart.getAllNodes().size() > 0) 
            {
                // Acessando o nó SmartArt no índice 0
                ISmartArtNode node = smart.getAllNodes().get_Item(0);
    
                // Removendo o nó selecionado
                smart.getAllNodes().removeNode(node);
            }
        }
    }
    
    // Salvar apresentação
    pres.save("RemoveSmartArtNode.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Remover um nó SmartArt de uma posição específica

Neste exemplo, aprenderemos a remover os nós dentro da forma SmartArt em uma posição particular.

  1. Crie uma instância da classe Presentation e carregue a apresentação com a forma SmartArt.
  2. Obtenha a referência do primeiro slide usando seu Índice.
  3. Percorra todas as formas dentro do primeiro slide.
  4. Verifique se a forma é do tipo SmartArt e faça cast da forma selecionada para SmartArt se for SmartArt.
  5. Selecione o nó da forma SmartArt no índice 0.
  6. Agora, verifique se o nó SmartArt selecionado tem mais de 2 nós filhos.
  7. Agora, remova o nó na Position 1 usando o método RemoveNode .
  8. Salve a apresentação.
// Carregar a apresentação desejada
Presentation pres = new Presentation("AddSmartArtNode.pptx");
try {
    // Percorrer todas as formas dentro do primeiro slide
    for (IShape shape : pres.getSlides().get_Item(0).getShapes()) 
    {
        // Verificar se a forma é do tipo SmartArt
        if (shape instanceof SmartArt) 
        {
            // Fazer cast da forma para SmartArt
            SmartArt smart = (SmartArt) shape;
    
            if (smart.getAllNodes().size() > 0) 
            {
                // Acessando o nó SmartArt no índice 0
                ISmartArtNode node = smart.getAllNodes().get_Item(0);
    
                if (node.getChildNodes().size() >= 2) 
                {
                    // Removendo o nó filho na posição 1
                    (node.getChildNodes()).removeNode(1);
                }
            }
        }
    }
    
    // Salvar apresentação
    pres.save("RemoveSmartArtNodeByPosition.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Definir uma posição personalizada para um nó filho em um objeto SmartArt

Agora o Aspose.Slides para Android via Java oferece suporte à definição das propriedades X e Y de SmartArtShape. O trecho de código abaixo mostra como definir posição, tamanho e rotação personalizados de SmartArtShape; observe que a adição de novos nós provoca um recálculo das posições e tamanhos de todos os nós. Também, com as configurações de posição personalizada, o usuário pode posicionar os nós conforme necessário.

// Instanciar a classe Presentation
Presentation pres = new Presentation("SimpleSmartArt.pptx");
try{
    ISmartArt smart = pres.getSlides().get_Item(0).getShapes().addSmartArt(20, 20, 600, 500, SmartArtLayoutType.OrganizationChart);

    // Mover a forma SmartArt para nova posição
    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);

    // Alterar as larguras da forma SmartArt
    node = smart.getAllNodes().get_Item(2);
    shape = node.getShapes().get_Item(1);
    shape.setWidth(shape.getWidth() + shape.getWidth() * 2);

    // Alterar a altura da forma SmartArt
    node = smart.getAllNodes().get_Item(3);
    shape = node.getShapes().get_Item(1);
    shape.setHeight(shape.getHeight() + shape.getHeight() * 2);

    // Alterar a rotação da forma 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();
}

Verificar um nó assistente

Usaremos a seguinte forma SmartArt de origem para nossa investigação nas diferentes seções deste artigo.

todo:image_alt_text
Figura: Forma SmartArt de origem no slide

No código de exemplo a seguir investigaremos como identificar Assistant Nodes na coleção de nós SmartArt e alterá‑los.

  1. Crie uma instância da classe Presentation e carregue a apresentação com a forma SmartArt.
  2. Obtenha a referência do segundo slide usando seu Índice.
  3. Percorra todas as formas dentro do primeiro slide.
  4. Verifique se a forma é do tipo SmartArt e faça cast da forma selecionada para SmartArt se for SmartArt.
  5. Percorra todos os nós dentro da forma SmartArt e verifique se são Assistant Nodes.
  6. Alterar o status do Nó Assistente para nó normal.
  7. Salve a apresentação.
// Criando uma instância de apresentação
Presentation pres = new Presentation("AddNodes.pptx");
try {
    // Percorrer todas as formas dentro do primeiro slide
    for (IShape shape : pres.getSlides().get_Item(0).getShapes()) 
    {
        // Verificar se a forma é do tipo SmartArt
        if (shape instanceof ISmartArt) 
        {
            // Fazer cast da forma para SmartArt
            ISmartArt smart = (SmartArt) shape;

            // Percorrendo todos os nós da forma SmartArt
            for (int i = 0; i < smart.getAllNodes().size(); i++) 
            {
                ISmartArtNode node = smart.getAllNodes().get_Item(i);
                // Verificar se o nó é um nó Assistente
                if (node.isAssistant()) 
                {
                    // Definir o nó Assistente como false e torná-lo um nó normal
                    node.isAssistant();
                }
            }
        }
    }

    // Salvar apresentação
    pres.save("ChangeAssitantNode.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}
todo:image_alt_text
Figura: Nós assistentes alterados na forma SmartArt dentro do slide

Definir o formato de preenchimento de um nó

Aspose.Slides para Android via Java permite adicionar formas SmartArt personalizadas e definir seu formato de preenchimento. Este artigo explica como criar e acessar formas SmartArt e definir seu formato de preenchimento usando Aspose.Slides para Android via Java.

Siga os passos abaixo:

  1. Crie uma instância da classe Presentation.
  2. Obtenha a referência de um slide usando seu índice.
  3. Adicione uma forma SmartArt definindo seu LayoutType.
  4. Defina o FillFormat para os nós da forma SmartArt.
  5. Grave a apresentação modificada como um arquivo PPTX.
// Instanciar a apresentação
Presentation pres = new Presentation();
try {
    // Acessando o slide
    ISlide slide = pres.getSlides().get_Item(0);
    
    // Adicionando forma SmartArt e nós
    ISmartArt chevron = slide.getShapes().addSmartArt(10, 10, 800, 60, SmartArtLayoutType.ClosedChevronProcess);
    ISmartArtNode node = chevron.getAllNodes().addNode();
    node.getTextFrame().setText("Some text");
    
    // Definindo a cor de preenchimento do nó
    for (IShape item : node.getShapes()) 
    {
        item.getFillFormat().setFillType(FillType.Solid);
        item.getFillFormat().getSolidFillColor().setColor(Color.RED);
    }
    
    // Salvar a apresentação
    pres.save("TestSmart.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Gerar uma miniatura de um nó filho SmartArt

Os desenvolvedores podem gerar uma miniatura do nó filho de um SmartArt seguindo os passos abaixo:

  1. Crie uma instância da classe Presentation.
  2. Adicione SmartArt.
  3. Obtenha a referência de um nó usando seu Índice.
  4. Obtenha a imagem em miniatura.
  5. Salve a imagem em miniatura em qualquer formato de imagem desejado.
// Instanciar a classe Presentation que representa o arquivo PPTX 
Presentation pres = new Presentation();
try {
    // Adicionar SmartArt 
    ISmartArt smart = pres.getSlides().get_Item(0).getShapes().addSmartArt(10, 10, 400, 300, SmartArtLayoutType.BasicCycle);

    // Obter a referência de um nó usando seu Índice  
    ISmartArtNode node = smart.getNodes().get_Item(1);

    // Obter miniatura
    IImage slideImage = node.getShapes().get_Item(0).getImage();

    // Salvar miniatura
    try {
          slideImage.save("SmartArt_ChildNote_Thumbnail.png", ImageFormat.Png);
    } finally {
         if (slideImage != null) slideImage.dispose();
    }
} finally {
    if (pres != null) pres.dispose();
}

FAQ

A animação SmartArt é suportada?

Sim. SmartArt é tratada como uma forma normal, portanto você pode aplicar animações padrão (entrada, saída, ênfase, caminhos de movimento) e ajustar o tempo. Também é possível animar formas dentro dos nós SmartArt quando necessário.

Como localizar de forma confiável um SmartArt específico em um slide se seu ID interno for desconhecido?

Atribua e procure por texto alternativo . Definir um AltText distinto no SmartArt permite encontrá‑lo programaticamente sem depender de identificadores internos.

A aparência do SmartArt será preservada ao converter a apresentação para PDF?

Sim. Aspose.Slides renderiza SmartArt com alta fidelidade visual durante a exportação para PDF, preservando layout, cores e efeitos.

Posso extrair uma imagem de todo o SmartArt (para pré‑visualizações ou relatórios)?

Sim. Você pode renderizar uma forma SmartArt para formatos raster ou para SVG para saída vetorial escalável, tornando‑a adequada para miniaturas, relatórios ou uso na web.

Gerenciar gráficos SmartArt em apresentações no Android