# グループ シェイプ

> Aspose.Slides for C++ でグループ化されたシェイプを管理します。C++ の例を使用して、PPT、PPTX、ODP プレゼンテーションでグループ シェイプの作成、入れ子化、配置、再順序付け、スタイル設定を行います。

Source: https://docs.aspose.com/slides/ja/cpp/examples/elements/group-shape/
Updated: 2026-02-19

**Aspose.Slides for C++** を使用して、シェイプのグループ作成、アクセス、グループ解除、および削除を行う例。

## **グループ シェイプの追加**

2つの基本シェイプを含むグループを作成します。

```cpp
static void AddGroupShape()
{
    auto presentation = MakeObject<Presentation>();
    auto slide = presentation->get_Slide(0);

    auto group = slide->get_Shapes()->AddGroupShape();
    group->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 0, 0, 50, 50);
    group->get_Shapes()->AddAutoShape(ShapeType::Ellipse, 60, 0, 50, 50);

    presentation->Dispose();
}
```

## **グループ シェイプにアクセス**

スライドから最初のグループ シェイプを取得します。

```cpp
static void AccessGroupShape()
{
    auto presentation = MakeObject<Presentation>();
    auto slide = presentation->get_Slide(0);

    auto group = slide->get_Shapes()->AddGroupShape();
    group->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 0, 0, 50, 50);

    auto firstGroup = SharedPtr<IGroupShape>();
    for (auto&& shape : slide->get_Shapes())
    {
        if (ObjectExt::Is<IGroupShape>(shape))
        {
            firstGroup = ExplicitCast<IGroupShape>(shape);
            break;
        }
    }

    presentation->Dispose();
}
```

## **グループ シェイプの削除**

スライドからグループ シェイプを削除します。

```cpp
static void RemoveGroupShape()
{
    auto presentation = MakeObject<Presentation>();
    auto slide = presentation->get_Slide(0);

    auto group = slide->get_Shapes()->AddGroupShape();

    slide->get_Shapes()->Remove(group);

    presentation->Dispose();
}
```

## **シェイプのグループ解除**

シェイプをグループ コンテナから外へ移動します。

```cpp
static void UngroupShapes()
{
    auto presentation = MakeObject<Presentation>();
    auto slide = presentation->get_Slide(0);

    auto group = slide->get_Shapes()->AddGroupShape();
    auto rect = group->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 0, 0, 50, 50);

    // シェイプをグループから外へ移動します。
    slide->get_Shapes()->AddClone(rect);
    group->get_Shapes()->Remove(rect);

    presentation->Dispose();
}
```