在 Java 中向演示文稿添加矩形

和之前的主题一样，本章节也讨论添加形状，这次我们将讨论的形状是 矩形。在本章节中，我们描述了开发人员如何使用 Aspose.Slides for Java 向幻灯片添加简单或格式化的矩形。

向幻灯片添加矩形

要向演示文稿的选定幻灯片添加一个简单的矩形，请按以下步骤操作：

• 创建 Presentation 类的实例。
• 通过其索引获取幻灯片的引用。
• 使用 IShapeCollection 对象公开的 addAutoShape 方法，添加类型为矩形的 IAutoShape。
• 将修改后的演示文稿写入 PPTX 文件。

在下面的示例中，我们已向演示文稿的第一张幻灯片添加了一个简单的矩形。

// 实例化表示 PPTX 的 Presentation 类
Presentation pres = new Presentation();
try {
    // 获取第一张幻灯片
    ISlide sld = pres.getSlides().get_Item(0);

    // 添加椭圆类型的 AutoShape
    IShape shp = sld.getShapes().addAutoShape(ShapeType.Rectangle, 50, 150, 150, 50);

    // 将 PPTX 文件写入磁盘
    pres.save("RecShp1.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

向幻灯片添加格式化矩形

要向幻灯片添加格式化矩形，请按以下步骤操作：

• 创建 Presentation 类的实例。
• 通过其索引获取幻灯片的引用。
• 使用 IShapeCollection 对象公开的 addAutoShape 方法，添加类型为矩形的 IAutoShape。
• 将矩形的 Fill Type 设置为 Solid。
• 使用与 IShape 对象关联的 IFillFormat 对象公开的 SolidFillColor.setColor 方法设置矩形的填充颜色。
• 设置矩形线条的颜色。
• 设置矩形线条的宽度。
• 将修改后的演示文稿写入 PPTX 文件。

上述步骤在下面的示例中实现。

// 实例化表示 PPTX 的 Presentation 类
Presentation pres = new Presentation();
try {
    // 获取第一张幻灯片
    ISlide sld = pres.getSlides().get_Item(0);

    // 添加椭圆类型的 AutoShape
    IShape shp = sld.getShapes().addAutoShape(ShapeType.Rectangle, 50, 150, 150, 50);

    // 对椭圆形状应用一些格式设置
    shp.getFillFormat().setFillType(FillType.Solid);
    shp.getFillFormat().getSolidFillColor().setColor(Color.GRAY);

    // 对椭圆的线条应用一些格式设置
    shp.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    shp.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    shp.getLineFormat().setWidth(5);

    // 将 PPTX 文件写入磁盘
    pres.save("RecShp2.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

FAQ

如何添加带圆角的矩形？

使用圆角的 shape type，并在形状属性中调整角半径；也可以通过几何调整对每个角单独进行圆角处理。

如何用图像（纹理）填充矩形？

选择图片 fill type，提供图像源，并配置 stretching/tiling modes。

矩形可以有阴影和发光效果吗？

可以。外部/内部阴影、发光以及柔和边缘 [/slides/java/shape-effect/] 均可使用，并可调节参数。

我可以把矩形设为带超链接的按钮吗？

可以。将超链接 [/slides/java/manage-hyperlinks/] 赋给形状的点击事件（跳转到幻灯片、文件、网页地址或电子邮件）。

如何保护矩形不被移动或修改？

使用形状锁 [/slides/java/applying-protection-to-presentation/]：可以禁止移动、调整大小、选择或文本编辑，以保持布局不变。

我可以将矩形转换为光栅图像或 SVG 吗？

可以。您可以使用 render the shape 将形状渲染为指定大小/比例的图像，或使用 export it as SVG 导出为 SVG 供矢量使用。

如何快速获取考虑主题和继承后的矩形实际（有效）属性？

使用形状的有效属性 [/slides/java/shape-effective-properties/]：API 返回已计算的值，包含主题样式、布局和本地设置的影响，简化格式分析。