PHP 中的组演示形状

添加组形状

Aspose.Slides 支持在幻灯片上使用组形状。此功能帮助开发者创建更丰富的演示文稿。Aspose.Slides for PHP via Java 支持添加或访问组形状。可以向已添加的组形状中添加形状以填充它，或访问组形状的任何属性。要使用 Aspose.Slides for PHP via Java 将组形状添加到幻灯片：

1. 创建 Presentation 类的实例。
2. 使用索引获取幻灯片的引用
3. 向幻灯片添加组形状。
4. 向已添加的组形状中添加形状。
5. 将修改后的演示文稿保存为 PPTX 文件。

下面的示例向幻灯片添加组形状。

  # 实例化 Presentation 类
  $pres = new Presentation();
  try {
    # 获取第一张幻灯片
    $sld = $pres->getSlides()->get_Item(0);
    # 访问幻灯片的形状集合
    $slideShapes = $sld->getShapes();
    # 向幻灯片添加组形状
    $groupShape = $slideShapes->addGroupShape();
    # 在已添加的组形状中添加形状
    $groupShape->getShapes()->addAutoShape(ShapeType::Rectangle, 300, 100, 100, 100);
    $groupShape->getShapes()->addAutoShape(ShapeType::Rectangle, 500, 100, 100, 100);
    $groupShape->getShapes()->addAutoShape(ShapeType::Rectangle, 300, 300, 100, 100);
    $groupShape->getShapes()->addAutoShape(ShapeType::Rectangle, 500, 300, 100, 100);
    # 添加组形状框架
    $groupShape->setFrame(new ShapeFrame(100, 300, 500, 40, NullableBool::False, NullableBool::False, 0));
    # 将 PPTX 文件写入磁盘
    $pres->save("GroupShape.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

访问 AltText 属性

本主题展示了添加组形状并访问幻灯片上组形状的 AltText 属性的简单步骤和代码示例。要使用 Aspose.Slides for PHP via Java 访问幻灯片中组形状的 AltText：

1. 实例化表示 PPTX 文件的 Presentation 类。
2. 使用索引获取幻灯片的引用。
3. 访问幻灯片的形状集合。
4. 访问组形状。
5. 访问 Alternative Text 属性。

下面的示例访问组形状的替代文本。

  # 实例化表示 PPTX 文件的 Presentation 类
  $pres = new Presentation("AltText.pptx");
  try {
    # 获取第一张幻灯片
    $sld = $pres->getSlides()->get_Item(0);
    for($i = 0; $i < java_values($sld->getShapes()->size()) ; $i++) {
      # 访问幻灯片的形状集合
      $shape = $sld->getShapes()->get_Item($i);
      if (java_instanceof($shape, new JavaClass("com.aspose.slides.GroupShape"))) {
        # 访问组形状。
        $grphShape = $shape;
        for($j = 0; $j < java_values($grphShape->getShapes()->size()) ; $j++) {
          $shape2 = $grphShape->getShapes()->get_Item($j);
          # 访问 AltText 属性
          echo($shape2->getAlternativeText());
        }
      }
    }
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

常见问题

是否支持嵌套分组（组内包含组）？

是的。GroupShape 具有 getParentGroup 方法，直接表明支持层级结构（一个组可以是另一个组的子组）。

如何控制组相对于幻灯片上其他对象的 Z 顺序？

使用 GroupShape 的 getZOrderPosition 方法检查其在显示堆栈中的位置。

我可以防止移动/编辑/取消组合吗？

是的。通过 GroupShapeLock 可访问组的锁定部分，您可以限制对该对象的操作。