Obsolete Members for QGraphicsItem

The following members of class QGraphicsItem are obsolete. They are provided to keep old source code working. We strongly advise against using them in new code.

Public Functions

Member Function Documentation

bool QGraphicsItem::acceptsHoverEvents() const

Call acceptHoverEvents() instead.

See also setAcceptsHoverEvents().

QList<QGraphicsItem *> QGraphicsItem::children() const

Use childItems() instead.

See also setParentItem().

bool QGraphicsItem::handlesChildEvents() const

Returns true if this item handles child events (i.e., all events intended for any of its children are instead sent to this item); otherwise, false is returned.

This property is useful for item groups; it allows one item to handle events on behalf of its children, as opposed to its children handling their events individually.

The default is to return false; children handle their own events. The exception for this is if the item is a QGraphicsItemGroup, then it defaults to return true.

See also setHandlesChildEvents().

QMatrix QGraphicsItem::matrix() const

Returns the item's affine transformation matrix. This is a subset or the item's full transformation matrix, and might not represent the item's full transformation.

Use transform() instead.

See also setMatrix(), setTransform(), and sceneTransform().

void QGraphicsItem::resetMatrix()

Use resetTransform() instead.

void QGraphicsItem::rotate(qreal angle)

Use

item->setTransform(QTransform().rotate(angle), true);

instead.

Rotates the current item transformation angle degrees clockwise around its origin. To translate around an arbitrary point (x, y), you need to combine translation and rotation with setTransform().

Example:

// Rotate an item 45 degrees around (0, 0).
item->rotate(45);

// Rotate an item 45 degrees around (x, y).
item->setTransform(QTransform().translate(x, y).rotate(45).translate(-x, -y));

See also setTransform(), transform(), scale(), shear(), and translate().

void QGraphicsItem::scale(qreal sx, qreal sy)

Use

setTransform(QTransform::fromScale(sx, sy), true);

instead.

Scales the current item transformation by (sx, sy) around its origin. To scale from an arbitrary point (x, y), you need to combine translation and scaling with setTransform().

Example:

// Scale an item by 3x2 from its origin
item->scale(3, 2);

// Scale an item by 3x2 from (x, y)
item->setTransform(QTransform().translate(x, y).scale(3, 2).translate(-x, -y));

See also setTransform() and transform().

QMatrix QGraphicsItem::sceneMatrix() const

Use sceneTransform() instead.

See also transform(), setTransform(), scenePos(), and The Graphics View Coordinate System.

void QGraphicsItem::setAcceptsHoverEvents(bool enabled)

Use setAcceptHoverEvents(enabled) instead.

See also acceptsHoverEvents().

void QGraphicsItem::setHandlesChildEvents(bool enabled)

If enabled is true, this item is set to handle all events for all its children (i.e., all events intented for any of its children are instead sent to this item); otherwise, if enabled is false, this item will only handle its own events. The default value is false.

This property is useful for item groups; it allows one item to handle events on behalf of its children, as opposed to its children handling their events individually.

If a child item accepts hover events, its parent will receive hover move events as the cursor passes through the child, but it does not receive hover enter and hover leave events on behalf of its child.

See also handlesChildEvents().

void QGraphicsItem::setMatrix(const QMatrix &matrix, bool combine = false)

Sets the item's affine transformation matrix. This is a subset or the item's full transformation matrix, and might not represent the item's full transformation.

Use setTransform() instead.

See also matrix(), transform(), and The Graphics View Coordinate System.

void QGraphicsItem::shear(qreal sh, qreal sv)

Use

setTransform(QTransform().shear(sh, sv), true);

instead.

Shears the current item transformation by (sh, sv).

See also setTransform() and transform().

void QGraphicsItem::translate(qreal dx, qreal dy)

Use setPos() or setTransformOriginPoint() instead. For identical behavior, use

setTransform(QTransform::fromTranslate(dx, dy), true);

Translates the current item transformation by (dx, dy).

If all you want is to move an item, you should call moveBy() or setPos() instead; this function changes the item's translation, which is conceptually separate from its position.

See also setTransform() and transform().