Управление SmartArt в презентациях PowerPoint с помощью Java

Получить текст из объекта SmartArt

Теперь метод TextFrame добавлен в интерфейс ISmartArtShape и класс SmartArtShape соответственно. Это свойство позволяет получить весь текст из SmartArt, если он содержит не только текст узлов. Следующий пример кода поможет вам получить текст из узла SmartArt.

Presentation pres = new Presentation("Presentation.pptx");
try {
    ISlide slide = pres.getSlides().get_Item(0);
    ISmartArt smartArt = (ISmartArt)slide.getShapes().get_Item(0);

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

Изменить тип компоновки объекта SmartArt

Чтобы изменить тип компоновки SmartArt. Выполните следующие действия:

Создайте экземпляр класса Presentation.
Получите ссылку на слайд, используя его индекс.
Добавьте SmartArt BasicBlockList.
Измените LayoutType на BasicProcess.
Сохраните презентацию в файл PPTX. В приведённом ниже примере мы добавили соединитель между двумя фигурами.

Presentation pres = new Presentation();
try {
    // Добавить SmartArt BasicProcess
    ISmartArt smart = pres.getSlides().get_Item(0).getShapes().addSmartArt(10, 10, 400, 300, SmartArtLayoutType.BasicBlockList);

    // Изменить LayoutType на BasicProcess
    smart.setLayout(SmartArtLayoutType.BasicProcess);

    // Сохранение презентации
    pres.save("ChangeSmartArtLayout_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Проверить свойство Visibility объекта SmartArt

Обратите внимание: метод ISmartArtNode.isHidden() возвращает true, если данный узел скрыт в модели данных. Чтобы проверить свойство скрытности любого узла SmartArt. Выполните следующие действия:

Создайте экземпляр класса Presentation.
Добавьте SmartArt RadialCycle.
Добавьте узел в SmartArt.
Проверьте свойство visibility.
Сохраните презентацию в файл PPTX. В приведённом ниже примере мы добавили соединитель между двумя фигурами.

Presentation pres = new Presentation();
try {
    // Добавить SmartArt BasicProcess 
    ISmartArt smart = pres.getSlides().get_Item(0).getShapes().addSmartArt(10, 10, 400, 300, SmartArtLayoutType.RadialCycle);

    // Добавить узел в SmartArt 
    ISmartArtNode node = smart.getAllNodes().addNode();

    // Проверить свойство isHidden
    boolean hidden = node.isHidden(); // Возвращает true

    if (hidden)
    {
        // Выполнить некоторые действия или уведомления
    }
    // Сохранение презентации
    pres.save("CheckSmartArtHiddenProperty_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Получить или установить тип организационной схемы

Методы ISmartArtNode.getOrganizationChartLayout() , setOrganizationChartLayout(int) позволяют получить или установить тип организационной схемы, связанный с текущим узлом. Чтобы получить или установить тип организационной схемы, выполните следующие действия:

Создайте экземпляр класса Presentation.
Добавьте SmartArt на слайд.
Получите или установите тип организационной схемы.
Сохраните презентацию в файл PPTX. В приведённом ниже примере мы добавили соединитель между двумя фигурами.

Presentation pres = new Presentation();
try {
    // Добавить SmartArt BasicProcess
    ISmartArt smart = pres.getSlides().get_Item(0).getShapes().addSmartArt(10, 10, 400, 300, SmartArtLayoutType.OrganizationChart);

    // Получить или установить тип организационной схемы
    smart.getNodes().get_Item(0).setOrganizationChartLayout(OrganizationChartLayoutType.LeftHanging);

    // Сохранение презентации
    pres.save("OrganizeChartLayoutType_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Создать схему Picture Organization

Aspose.Slides for Java предоставляет простой API для создания диаграмм PictureOrganization. Чтобы создать диаграмму на слайде:

Создайте экземпляр класса Presentation.
Получите ссылку на слайд по его индексу.
Добавьте диаграмму с данными по умолчанию и нужным типом (ChartType.PictureOrganizationChart).
Сохраните изменённую презентацию в файл PPTX

Следующий код используется для создания диаграммы.

Presentation pres = new Presentation("test.pptx");
try {
    ISmartArt smartArt = pres.getSlides().get_Item(0).getShapes().addSmartArt(0, 0, 400, 400, SmartArtLayoutType.PictureOrganizationChart);
    pres.save("OrganizationChart.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Получить или установить состояние SmartArt

Чтобы изменить тип компоновки SmartArt. Выполните следующие действия:

Создайте экземпляр класса Presentation.
Добавьте SmartArt на слайд.
Получите или установите состояние диаграммы SmartArt.
Сохраните презентацию в файл PPTX.

Следующий код используется для создания диаграммы.

// Создать экземпляр класса Presentation, представляющего файл PPTX
Presentation pres = new Presentation();
try {
    // Добавить SmartArt BasicProcess
    ISmartArt smart = pres.getSlides().get_Item(0).getShapes().addSmartArt(10, 10, 400, 300, SmartArtLayoutType.BasicProcess);
    
    // Получить или установить состояние диаграммы SmartArt
    smart.setReversed(true);
    boolean flag = smart.isReversed();
    
    // Сохранение презентации
    pres.save("output.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

FAQ

Поддерживает ли SmartArt зеркальное отображение/реверс для RTL-языков?

Да. Метод setReversed переключает направление диаграммы (LTR/RTL), если выбранный тип SmartArt поддерживает реверс.

Как скопировать SmartArt на тот же слайд или в другую презентацию, сохранив форматирование?

Вы можете клонировать форму SmartArt через коллекцию форм (ShapeCollection.addClone) или клонировать весь слайд содержащий эту форму. Оба подхода сохраняют размер, позицию и стили.

Как отрендерить SmartArt в растровое изображение для предварительного просмотра или веб-экспорта?

Отрендерьте слайд (или всю презентацию) в PNG/JPEG через API, преобразующее слайды/презентации в изображения — SmartArt будет отрисован как часть слайда.

Как программно выбрать конкретный SmartArt на слайде, если их несколько?

Обычно используют альтернативный текст (Alt Text) или имя и ищут форму по этому атрибуту в пределах форм слайда, затем проверяют тип, чтобы убедиться, что это SmartArt. Документация описывает типичные техники поиска и работы с формами.

Управление графикой SmartArt в презентациях с помощью Java