在 PHP 中向演示文稿添加线形状

创建普通线条

要向演示文稿的选定幻灯片添加一条简单的普通线条,请按照以下步骤操作:

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

在下面的示例中,我们已在演示文稿的第一张幻灯片上添加了一条线。

  # 实例化表示 PPTX 文件的 PresentationEx 类
  $pres = new Presentation();
  try {
    # 获取第一张幻灯片
    $sld = $pres->getSlides()->get_Item(0);
    # 添加类型为 line 的 AutoShape
    $sld->getShapes()->addAutoShape(ShapeType::Line, 50, 150, 300, 0);
    # 将 PPTX 写入磁盘
    $pres->save("LineShape.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

创建箭头形线条

Aspose.Slides for PHP via Java 还允许开发人员配置线条的某些属性,使其外观更具吸引力。让我们尝试配置线条的几个属性,使其看起来像箭头。请按照以下步骤操作:

  • 创建一个 Presentation 类的实例。
  • 通过使用其 Index 获取幻灯片的引用。
  • 使用 IShapeCollection 对象公开的 addAutoShape 方法,添加 Line 类型的 AutoShape。
  • Line Style 设置为 Aspose.Slides for PHP via Java 提供的样式之一。
  • 设置线条的宽度。
  • 将线条的 Dash Style 设置为 Aspose.Slides for PHP via Java 提供的样式之一。
  • 设置线条起点的 Arrow Head StyleLength
  • 设置线条终点的 Arrow Head StyleLength
  • 将修改后的演示文稿写入为 PPTX 文件。
  # 实例化表示 PPTX 文件的 PresentationEx 类
  $pres = new Presentation();
  try {
    # 获取第一张幻灯片
    $sld = $pres->getSlides()->get_Item(0);
    # 添加类型为 line 的 AutoShape
    $shp = $sld->getShapes()->addAutoShape(ShapeType::Line, 50, 150, 300, 0);
    # 对线条应用一些格式设置
    $shp->getLineFormat()->setStyle(LineStyle->ThickBetweenThin);
    $shp->getLineFormat()->setWidth(10);
    $shp->getLineFormat()->setDashStyle(LineDashStyle->DashDot);
    $shp->getLineFormat()->setBeginArrowheadLength(LineArrowheadLength->Short);
    $shp->getLineFormat()->setBeginArrowheadStyle(LineArrowheadStyle->Oval);
    $shp->getLineFormat()->setEndArrowheadLength(LineArrowheadLength->Long);
    $shp->getLineFormat()->setEndArrowheadStyle(LineArrowheadStyle->Triangle);
    $shp->getLineFormat()->getFillFormat()->setFillType(FillType::Solid);
    $shp->getLineFormat()->getFillFormat()->getSolidFillColor()->setColor(new java("java.awt.Color", PresetColor->Maroon));
    # 将 PPTX 写入磁盘
    $pres->save("LineShape.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

常见问题

我可以将普通线条转换为连接器以便它“捕捉”到形状上吗?

不可以。普通线条(类型为 LineAutoShape)不会自动变为连接器。要使其捕捉到形状,请使用专用的 Connector 类型以及用于连接的 对应 API

如果线条的属性从主题继承,导致难以确定最终值,我该怎么办?

通过 LineFormatEffectiveData/LineFillFormatEffectiveData 读取有效属性——这些已考虑继承和主题样式。

我可以锁定线条以防止编辑(移动、调整大小)吗?

可以。形状提供了 lock objects,可以让您 禁止编辑操作