在 JavaScript 中管理演示文稿形状

在幻灯片中查找形状

本主题将描述一种简单技术，使开发人员能够在不使用内部 Id 的情况下更轻松地在幻灯片上查找特定形状。需要了解的是，PowerPoint 演示文稿文件除了内部唯一 Id 外，无法以其他方式标识幻灯片上的形状。使用内部唯一 Id 查找形状对开发人员来说通常比较困难。添加到幻灯片的所有形状都有一些替代文本（Alt Text）。我们建议开发人员使用替代文本来查找特定形状。您可以使用 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. 将文件保存到磁盘。

// 实例化表示 PPTX 的 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(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 方法返回的值对应 Microsoft.Office.Interop.PowerPoint.Shape 对象 Id 的值。下面给出示例代码。

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 方法进行区分。

使用 Aspose.Slides 以及 Microsoft PowerPoint，您可以读取或设置 setAlternativeText 和 getAlternativeText 方法。

通过此方法，您可以为形状打标签，并可执行诸如删除形状、隐藏形状或在幻灯片上重新排序形状等不同操作。

要为形状设置 AlternateText，请按照以下步骤操作：

1. 创建 Presentation 类的实例。
2. 访问第一张幻灯片。
3. 向幻灯片添加任意形状。
4. 对新添加的形状进行一些操作。
5. 遍历形状以查找目标形状。
6. 设置 AlternativeText。
7. 将文件保存到磁盘。

// 实例化表示 PPTX 的 Presentation 类
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。已在 Shape 类中添加了方法 writeAsSvg（及其重载）。此方法允许将形状的内容保存为 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 枚举定义了可能的对齐选项。

Example 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();
    }
}

Example 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 文件，其中的第一张幻灯片包含一个默认翻转设置的单一形状，如下所示。

以下代码示例获取形状当前的翻转属性，并同时水平和垂直翻转该形状。

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); // Flip horizontally.
    var flipV = java.newByte(asposeSlides.NullableBool.True); // Flip vertically.
    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();
}

结果：

常见问题

我能像桌面编辑器那样在幻灯片上合并形状（union/intersect/subtract）吗？

目前没有内置的布尔运算 API。您可以通过自行构造所需轮廓来近似实现，例如使用 GeometryPath 计算结果几何形状，然后创建具有该轮廓的新形状，必要时删除原始形状。

如何控制堆叠顺序（z-order），使形状始终保持在最上层？

更改幻灯片的 shapes 集合中的插入/移动顺序。为获得可预测的结果，建议在完成所有其他幻灯片修改后再最终确定 z-order。

我能“锁定”形状，以防止用户在 PowerPoint 中编辑它吗？

可以。设置形状级别的保护标志（例如锁定选择、移动、大小调整、文本编辑）。如有需要，可在母版或布局上镜像相同限制。请注意，这是一种 UI 级别的保护，而非安全特性；若需更强的保护，可结合文件级别的限制，例如只读建议或密码。