#include <KoShapeContainer.h>

Public Member Functions
void	addShape (KoShape *shape)

void	removeShape (KoShape *shape)

	ShapeInterface (KoShapeContainer *_q)

Protected Attributes
KoShapeContainer *	q

Detailed Description

A special interface for KoShape to use during setParent call. Don't use these method directly for managing shapes hierarchy! Use shape->setParent() instead.

Definition at line 202 of file KoShapeContainer.h.

Constructor & Destructor Documentation

◆ ShapeInterface()

KoShapeContainer::ShapeInterface::ShapeInterface ( KoShapeContainer * _q )

Definition at line 175 of file KoShapeContainer.cpp.

    : q(_q)
{
}

Member Function Documentation

◆ addShape()

void KoShapeContainer::ShapeInterface::addShape ( KoShape * shape )

Add a child to this container.

This container will NOT take over ownership of the shape. The caller or those creating the shape is responsible to delete it if not needed any longer.

Parameters

shape the child to be managed in the container.

Definition at line 180 of file KoShapeContainer.cpp.

{
    KoShapeContainer::Private * const d = q->d.data();
 
    KIS_SAFE_ASSERT_RECOVER_RETURN(shape);
 
    if (shape->parent() == q && q->shapes().contains(shape)) {
        return;
    }
 
    // TODO add a method to create a default model depending on the shape container
    if (!d->model) {
        d->model = new SimpleShapeContainerModel();
    }
 
    if (shape->parent() && shape->parent() != q) {
        shape->parent()->shapeInterface()->removeShape(shape);
    }
 
    d->model->add(shape);
    d->model->shapeHasBeenAddedToHierarchy(shape, q);
}

References KoShapeContainer::d, KIS_SAFE_ASSERT_RECOVER_RETURN, KoShape::parent(), removeShape(), KoShapeContainer::shapeInterface, and KoShapeContainer::shapes().

◆ removeShape()

void KoShapeContainer::ShapeInterface::removeShape ( KoShape * shape )

Remove a child to be completely separated from the container.

The shape will only be removed from this container but not be deleted.

Parameters

shape the child to be removed.

Definition at line 203 of file KoShapeContainer.cpp.

{
    KoShapeContainer::Private * const d = q->d.data();
 
    KIS_SAFE_ASSERT_RECOVER_RETURN(shape);
    KIS_SAFE_ASSERT_RECOVER_RETURN(d->model);
    KIS_SAFE_ASSERT_RECOVER_RETURN(d->model->shapes().contains(shape));
 
    d->model->shapeToBeRemovedFromHierarchy(shape, q);
    d->model->remove(shape);
 
    KoShapeContainer *grandparent = q->parent();
    if (grandparent) {
        grandparent->model()->childChanged(q, KoShape::ChildChanged);
    }
}

References KoShape::ChildChanged, KoShapeContainerModel::childChanged(), KoShapeContainer::d, KIS_SAFE_ASSERT_RECOVER_RETURN, KoShapeContainer::model, and KoShape::parent().

Member Data Documentation

◆ q

KoShapeContainer* KoShapeContainer::ShapeInterface::q

protected

Definition at line 225 of file KoShapeContainer.h.

The documentation for this struct was generated from the following files:

libs/flake/KoShapeContainer.h
libs/flake/KoShapeContainer.cpp

Public Member Functions

Protected Attributes