Управление 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();
}

Проверка свойства Hidden у объекта SmartArt

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

Создайте экземпляр класса Presentation.
Добавьте SmartArt RadialCycle.
Добавьте узел в SmartArt.
Проверьте свойство isHidden .
Запишите презентацию в файл 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