Манипуляции фигурами

Найти фигуру на слайде

В этой статье описывается простая техника, позволяющая разработчикам проще находить конкретную фигуру на слайде без использования её внутреннего Id. Важно знать, что файлы презентаций PowerPoint не предоставляют способа идентифицировать фигуры на слайде, кроме внутреннего уникального Id. Разработчикам часто сложно находить фигуру по её внутреннему уникальному Id. Все фигуры, добавленные на слайды, имеют альтернативный текст. Мы предлагаем разработчикам использовать альтернативный текст для поиска конкретной фигуры. Вы можете использовать MS PowerPoint, чтобы задать альтернативный текст объектам, которые планируете изменять в будущем.

После установки альтернативного текста нужной фигуры вы можете открыть эту презентацию с помощью Aspose.Slides for Node.js via Java и перебрать все фигуры, добавленные на слайд. На каждой итерации вы проверяете альтернативный текст фигуры, и фигура с совпадающим альтернативным текстом будет требуемой. Чтобы продемонстрировать эту технику, мы создали метод findShape , который выполняет поиск конкретной фигуры на слайде и просто возвращает её.

// Создать экземпляр класса Presentation, представляющий файл презентации
var pres = new aspose.slides.Presentation("FindingShapeInSlide.pptx");
try {
    var slide = pres.getSlides().get_Item(0);
    // Альтернативный текст фигуры, которую нужно найти
    var shape = findShape(slide, "Shape1");
    if (shape != null) {
        console.log("Shape Name: " + shape.getName());
    }
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

function findShape(slide, altText) {
    let shapes = slide.getShapes();
    
    for (let i = 0; i < shapes.size(); i++) {
        let shape = shapes.get_Item(i);
        
        if (shape.getAlternativeText() === altText) {
            return shape;
        }
    }

    return null;
}

Клонировать фигуру

Чтобы клонировать фигуру на слайд с помощью Aspose.Slides for Node.js via Java:

  1. Создать экземпляр класса Presentation.
  2. Получить ссылку на слайд, используя его индекс.
  3. Получить коллекцию фигур исходного слайда.
  4. Добавить новый слайд в презентацию.
  5. Клонировать фигуры из коллекции фигур исходного слайда в новый слайд.
  6. Сохранить изменённую презентацию как файл PPTX.

Ниже приведён пример, который добавляет групповую фигуру на слайд.

// Создать экземпляр класса Presentation
var pres = new aspose.slides.Presentation("Source Frame.pptx");
try {
    var sourceShapes = pres.getSlides().get_Item(0).getShapes();
    var blankLayout = pres.getMasters().get_Item(0).getLayoutSlides().getByType(aspose.slides.SlideLayoutType.Blank);
    var destSlide = pres.getSlides().addEmptySlide(blankLayout);
    var destShapes = destSlide.getShapes();
    destShapes.addClone(sourceShapes.get_Item(1), 50, 150 + sourceShapes.get_Item(0).getHeight());
    destShapes.addClone(sourceShapes.get_Item(2));
    destShapes.insertClone(0, sourceShapes.get_Item(0), 50, 150);
    // Записать файл PPTX на диск
    pres.save("CloneShape_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Удалить фигуру

Aspose.Slides for Node.js via Java позволяет разработчикам удалять любую фигуру. Чтобы удалить фигуру с любого слайда, выполните следующие шаги:

  1. Создать экземпляр класса Presentation.
  2. Получить доступ к первому слайду.
  3. Найти фигуру с заданным AlternativeText.
  4. Удалить фигуру.
  5. Сохранить файл на диск.
// Создать объект Presentation
var pres = new aspose.slides.Presentation();
try {
    // Получить первый слайд
    var sld = pres.getSlides().get_Item(0);
    // Добавить автоконтур типа прямоугольник
    sld.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 40, 150, 50);
    sld.getShapes().addAutoShape(aspose.slides.ShapeType.Moon, 160, 40, 150, 50);
    var altText = "User Defined";
    var iCount = sld.getShapes().size();
    for (var i = 0; i < iCount; i++) {
        var ashp = sld.getShapes().get_Item(0);
        if (alttext === ashp.getAlternativeText()) {
            sld.getShapes().remove(ashp);
        }
    }
    // Сохранить презентацию на диск
    pres.save("RemoveShape_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Скрыть фигуру

Aspose.Slides for Node.js via Java позволяет разработчикам скрывать любую фигуру. Чтобы скрыть фигуру на любом слайде, выполните следующие шаги:

  1. Создать экземпляр класса Presentation.
  2. Получить доступ к первому слайду.
  3. Найти фигуру с заданным AlternativeText.
  4. Скрыть фигуру.
  5. Сохранить файл на диск.
// Создать экземпляр класса Presentation, представляющего PPTX
var pres = new aspose.slides.Presentation();
try {
    // Получить первый слайд
    var sld = pres.getSlides().get_Item(0);
    // Добавить автофигуру типа прямоугольник
    sld.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 40, 150, 50);
    sld.getShapes().addAutoShape(aspose.slides.ShapeType.Moon, 160, 40, 150, 50);
    var alttext = "User Defined";
    var iCount = sld.getShapes().size();
    for (var i = 0; i < iCount; i++) {
        var ashp = sld.getShapes().get_Item(i);
        if (alttext === ashp.getAlternativeText()) {
            ashp.setHidden(true);
        }
    }
    // Сохранить презентацию на диск
    pres.save("Hiding_Shapes_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Изменить порядок фигур

Aspose.Slides for Node.js via Java позволяет разработчикам менять порядок расположения фигур. Перестановка фигур определяет, какая фигура находится спереди, а какая — сзади. Чтобы изменить порядок фигур на любом слайде, выполните следующие шаги:

  1. Создать экземпляр класса Presentation.
  2. Получить доступ к первому слайду.
  3. Добавить фигуру.
  4. Добавить текст в текстовый фрейм фигуры.
  5. Добавить ещё одну фигуру с теми же координатами.
  6. Переставить фигуры.
  7. Сохранить файл на диск.
var pres = new aspose.slides.Presentation("ChangeShapeOrder.pptx");
try {
    var slide = pres.getSlides().get_Item(0);
    var shp3 = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 200, 365, 400, 150);
    shp3.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
    shp3.addTextFrame(" ");
    var para = shp3.getTextFrame().getParagraphs().get_Item(0);
    var portion = para.getPortions().get_Item(0);
    portion.setText("Watermark Text Watermark Text Watermark Text");
    shp3 = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Triangle, 200, 365, 400, 150);
    slide.getShapes().reorder(2, shp3);
    pres.save("Reshape_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Получить Interop Shape ID

Aspose.Slides for Node.js via Java позволяет разработчикам получить уникальный идентификатор фигуры в пределах слайда, в отличие от метода getUniqueId , который возвращает уникальный идентификатор в масштабе всей презентации. Метод getOfficeInteropShapeId был добавлен в класс Shape. Значение, возвращаемое методом getOfficeInteropShapeId , соответствует Id объекта Microsoft.Office.Interop.PowerPoint.Shape. Ниже приведён пример кода.

var pres = new aspose.slides.Presentation("Presentation.pptx");
try {
    // Получение уникального идентификатора фигуры в области слайда
    var officeInteropShapeId = pres.getSlides().get_Item(0).getShapes().get_Item(0).getOfficeInteropShapeId();
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Установить альтернативный текст для фигуры

Aspose.Slides for Node.js via Java позволяет разработчикам задавать AlternateText любой фигуры. Фигуры в презентации могут быть различены с помощью метода AlternativeText или Shape Name. Методы setAlternativeText и getAlternativeText могут быть использованы как в Aspose.Slides, так и в Microsoft PowerPoint. С их помощью вы можете пометить фигуру и выполнять различные операции, такие как удаление, скрытие или переупорядочивание фигур на слайде. Чтобы установить AlternateText для фигуры, выполните следующие шаги:

  1. Создать экземпляр класса Presentation.
  2. Получить доступ к первому слайду.
  3. Добавить любую фигуру на слайд.
  4. Выполнить необходимые действия с добавленной фигурой.
  5. Пройтись по фигурам, чтобы найти нужную.
  6. Установить AlternativeText.
  7. Сохранить файл на диск.
// Создать экземпляр класса Presentation, представляющего PPTX
var pres = new aspose.slides.Presentation();
try {
    // Получить первый слайд
    var sld = pres.getSlides().get_Item(0);
    // Добавить автофигуру типа прямоугольник
    var shp1 = sld.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 40, 150, 50);
    var shp2 = sld.getShapes().addAutoShape(aspose.slides.ShapeType.Moon, 160, 40, 150, 50);
    shp2.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    shp2.getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "GRAY"));
    for (var i = 0; i < sld.getShapes().size(); i++) {
        var shape = sld.getShapes().get_Item(i);
        if (shape != null) {
            shape.setAlternativeText("User Defined");
        }
    }
    // Сохранить презентацию на диск
    pres.save("Set_AlternativeText_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Доступ к форматам макета для фигуры

Aspose.Slides for Node.js via Java предоставляет простой API для доступа к форматам макета фигуры. В этой статье показано, как получить доступ к форматам макета.

Ниже приведён пример кода.

var pres = new aspose.slides.Presentation("pres.pptx");
try {
    for (let i = 0; i < pres.getLayoutSlides().size(); i++) {
        let layoutSlide = pres.getLayoutSlides().get_Item(i);
        for (let j = 0; j < layoutSlide.getShapes().size(); j++) {
            let shape = layoutSlide.getShapes().get_Item(j);
            var fillFormats = shape.getFillFormat();
            var lineFormats = shape.getLineFormat();
        }
    }
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Отрисовать фигуру как SVG

Теперь Aspose.Slides for Node.js via Java поддерживает отрисовку фигуры в формате SVG. Метод writeAsSvg (и его перегрузка) был добавлен в класс Shape. Этот метод позволяет сохранять содержимое фигуры в SVG‑файл. Ниже показан фрагмент кода, экспортирующий фигуру слайда в SVG‑файл.

var pres = new aspose.slides.Presentation("TestExportShapeToSvg.pptx");
try {
    var stream = java.newInstanceSync("java.io.FileOutputStream", "SingleShape.svg");
    try {
        pres.getSlides().get_Item(0).getShapes().get_Item(0).writeAsSvg(stream);
    } finally {
        if (stream != null) {
            stream.close();
        }
    }
} catch (e) {console.log(e);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Выравнивание фигур

Aspose.Slides позволяет выравнивать фигуры либо относительно полей слайда, либо относительно друг друга. Для этой цели была добавлена перегруженная версия метода SlidesUtil.alignShape(). Перечисление ShapesAlignmentType определяет возможные варианты выравнивания.

Пример 1

Приведённый ниже код выравнивает фигуры с индексами 1, 2 и 4 по верхней границе слайда.

var pres = new aspose.slides.Presentation("example.pptx");
try {
    var slide = pres.getSlides().get_Item(0);
    var shape1 = slide.getShapes().get_Item(1);
    var shape2 = slide.getShapes().get_Item(2);
    var shape3 = slide.getShapes().get_Item(4);
    aspose.slides.SlideUtil.alignShapes(aspose.slides.ShapesAlignmentType.AlignTop, true, pres.getSlides().get_Item(0), java.newArray("int", [slide.getShapes().indexOf(shape1), slide.getShapes().indexOf(shape2), slide.getShapes().indexOf(shape3)]));
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Пример 2

В этом примере показано, как выравнивать всю коллекцию фигур относительно самой нижней фигуры в коллекции.

var pres = new aspose.slides.Presentation("example.pptx");
try {
    aspose.slides.SlideUtil.alignShapes(aspose.slides.ShapesAlignmentType.AlignBottom, false, pres.getSlides().get_Item(0));
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Свойства отражения

В Aspose.Slides класс ShapeFrame предоставляет управление горизонтальным и вертикальным отражением фигур через свойства flipH и flipV. Оба свойства имеют тип byte и могут принимать значение 1 для отражения, 0 — без отражения, или -1 для использования поведения по умолчанию. Эти значения доступны через Frame фигуры.

Чтобы изменить настройки отражения, создаётся новый экземпляр ShapeFrame с текущими позицией и размерами фигуры, желаемыми значениями flipH и flipV и углом вращения. Присвоив этот экземпляр свойству Frame и сохранив презентацию, вы применяете зеркальные трансформации и фиксируете их в выходном файле.

Предположим, у нас есть файл sample.pptx, в котором на первом слайде находится одна фигура с настройками отражения по умолчанию, как показано ниже.

The shape to be flipped

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

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

    // Получить свойство горизонтального отражения фигуры.
    var horizontalFlip = shape.getFrame().getFlipH();
    console.log("Horizontal flip:", horizontalFlip);

    // Получить свойство вертикального отражения фигуры.
    var verticalFlip = shape.getFrame().getFlipV();
    console.log("Vertical flip:", verticalFlip);

    var x = java.newFloat(shape.getFrame().getX());
    var y = java.newFloat(shape.getFrame().getY());
    var width = java.newFloat(shape.getFrame().getWidth());
    var height = java.newFloat(shape.getFrame().getHeight());
    var flipH = java.newByte(asposeSlides.NullableBool.True); // Отразить по горизонтали.
    var flipV = java.newByte(asposeSlides.NullableBool.True); // Отразить по вертикали.
    var rotation = shape.getFrame().getRotation();

    shape.setFrame(new asposeSlides.ShapeFrame(x, y, width, height, flipH, flipV, rotation));

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

Результат:

The flipped shape

FAQ

Можно ли объединять фигуры (union/intersect/subtract) на слайде, как в настольных редакторах?

Встроенного API для булевых операций нет. Можно приблизительно реализовать это, построив желаемый контур самостоятельно — например, вычислив полученную геометрию через GeometryPath и создав новую фигуру с этим контуром, при необходимости удалив исходные.

Как контролировать порядок наложения (z‑order), чтобы фигура всегда была «наверху»?

Изменяйте порядок вставки/перемещения внутри коллекции shapes слайда. Для предсказуемых результатов фиксируйте z‑order после всех остальных изменений слайда.

Можно ли «запретить» редактирование фигуры пользователями в PowerPoint?

Да. Установите флаги защиты уровня фигуры (например, блокировку выбора, перемещения, изменения размера, редактирования текста). При необходимости наложите аналогичные ограничения на мастер или макет. Учтите, что это защита уровня пользовательского интерфейса, а не полноценная безопасность; для более надёжной защиты комбинируйте её с ограничениями на уровне файла, например, рекомендациями в режиме только чтения или паролями /slides/nodejs-java/password-protected-presentation/.

Просмотрщик презентаций