Gerenciar SmartArt em Apresentações PowerPoint Usando Java

Visão geral

SmartArt é um diagrama do PowerPoint composto por nós, formas de nó e um layout. Com Aspose.Slides para Java, você pode criar SmartArt, ler texto de seus nós, alterar seu layout, inspecionar nós ocultos, configurar layouts de organogramas e criar organogramas com imagens.

Obter texto de um objeto SmartArt

Um nó de SmartArt pode conter uma ou mais formas. Para ler o texto visível, itere através de ISmartArt.getAllNodes, e então leia o ITextFrame retornado por ISmartArtShape.getTextFrame.

Presentation presentation = new Presentation("sample.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IShape shape = slide.getShapes().get_Item(0);

    if (shape instanceof ISmartArt) {
        ISmartArt smartArt = (ISmartArt) shape;

        for (ISmartArtNode node : smartArt.getAllNodes()) {
            for (ISmartArtShape nodeShape : node.getShapes()) {
                if (nodeShape.getTextFrame() != null) {
                    System.out.println(nodeShape.getTextFrame().getText());
                }
            }
        }
    }
} finally {
    presentation.dispose();
}

Alterar o tipo de layout de um objeto SmartArt

O layout do SmartArt controla como os nós são organizados e conectados. O exemplo a seguir cria um objeto SmartArt com o valor BasicBlockList do SmartArtLayoutType, altera para o valor BasicProcess e salva a apresentação.

Presentation presentation = new Presentation();
try {
    ISmartArt smartArt = presentation.getSlides().get_Item(0).getShapes().addSmartArt(
        10, 10, 400, 300, SmartArtLayoutType.BasicBlockList);

    smartArt.setLayout(SmartArtLayoutType.BasicProcess);

    presentation.save("ChangeSmartArtLayout_out.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Verificar se um nó SmartArt está oculto

ISmartArtNode.isHidden indica se o nó está oculto no modelo de dados do SmartArt. Nós ocultos podem existir na estrutura mesmo quando o layout selecionado não os exibe como elementos visíveis do diagrama.

O exemplo a seguir adiciona um nó a um objeto SmartArt que usa o valor RadialCycle do SmartArtLayoutType e verifica o estado oculto do nó.

Presentation presentation = new Presentation();
try {
    ISmartArt smartArt = presentation.getSlides().get_Item(0).getShapes().addSmartArt(
        10, 10, 400, 300, SmartArtLayoutType.RadialCycle);

    ISmartArtNode node = smartArt.getAllNodes().addNode();
    boolean isHidden = node.isHidden();

    if (isHidden) {
        System.out.println("The node is hidden in the SmartArt data model.");
    }

    presentation.save("CheckSmartArtHiddenProperty_out.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Obter ou definir o layout do organograma

Para diagramas SmartArt que utilizam um layout de organograma, ISmartArtNode.getOrganizationChartLayout e ISmartArtNode.setOrganizationChartLayout definem como os nós filhos são organizados sob um nó pai. Por exemplo, é possível definir que os nós filhos pendam à esquerda, à direita ou de ambos os lados, dependendo do OrganizationChartLayoutType selecionado.

O exemplo a seguir cria um organograma e define o layout do primeiro nó para o valor LeftHanging do OrganizationChartLayoutType.

Presentation presentation = new Presentation();
try {
    ISmartArt smartArt = presentation.getSlides().get_Item(0).getShapes().addSmartArt(
        10, 10, 400, 300, SmartArtLayoutType.OrganizationChart);

    ISmartArtNode rootNode = smartArt.getNodes().get_Item(0);
    rootNode.setOrganizationChartLayout(OrganizationChartLayoutType.LeftHanging);

    presentation.save("OrganizationChartLayout_out.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Criar um organograma de imagem

Um organograma de imagem é um layout SmartArt projetado para diagramas hierárquicos que incluem espaços reservados para imagens. Use o valor PictureOrganizationChart do SmartArtLayoutType ao adicionar o objeto SmartArt a um slide.

Presentation presentation = new Presentation();
try {
    ISmartArt smartArt = presentation.getSlides().get_Item(0).getShapes().addSmartArt(
        0, 0, 400, 400, SmartArtLayoutType.PictureOrganizationChart);

    presentation.save("PictureOrganizationChart_out.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Perguntas frequentes

O SmartArt oferece suporte a espelhamento ou inversão para idiomas RTL?

Sim. O método ISmartArt.setReversed altera a direção do diagrama de esquerda‑para‑direita para direita‑para‑esquerda, ou vice‑versa, quando o layout SmartArt selecionado suporta inversão.

Como posso copiar o SmartArt para o mesmo slide ou para outra apresentação preservando a formatação?

Você pode clonar a forma SmartArt usando ShapeCollection.addClone ou clonar todo o slide que contém o SmartArt (/slides/pt/java/clone-slides/). Ambas as abordagens preservam tamanho, posição e formatação.

Como renderizar o SmartArt para uma imagem raster para visualização ou exportação para web?

Renderize o slide (/slides/pt/java/convert-powerpoint-to-png/) ou a apresentação completa para PNG ou JPEG. O SmartArt é renderizado como parte do slide.

Como localizar um objeto SmartArt específico em um slide se houver vários?

Defina um texto alternativo ou um nome distintivo usando Shape.getAlternativeText ou Shape.getName na forma SmartArt, procure esse valor em BaseSlide.getShapes, e então verifique se a forma correspondente é um ISmartArt.