Contents

• Public Types
• Public Functions
• Reimplemented Public Functions
• Detailed Description

Detailed Description

TheQGraphicsPixmapItem class provides a pixmap item that you can add to aQGraphicsScene.

To set the item's pixmap, pass aQPixmap toQGraphicsPixmapItem's constructor, or call thesetPixmap() function. Thepixmap() function returns the current pixmap.

QGraphicsPixmapItem uses pixmap's optional alpha mask to provide a reasonable implementation ofboundingRect(),shape(), andcontains().

The pixmap is drawn at the item's (0, 0) coordinate, as returned byoffset(). You can change the drawing offset by callingsetOffset().

You can set the pixmap's transformation mode by callingsetTransformationMode(). By default,Qt::FastTransformation is used, which provides fast, non-smooth scaling.Qt::SmoothTransformation enablesQPainter::SmoothPixmapTransform on the painter, and the quality depends on the platform and viewport. The result is usually not as good as calling QPixmap::scale() directly. CalltransformationMode() to get the current transformation mode for the item.

Member Type Documentation

enum QGraphicsPixmapItem::ShapeMode

This enum describes howQGraphicsPixmapItem calculates its shape and opaque area.

The default value is MaskShape.

Member Function Documentation

QGraphicsPixmapItem::QGraphicsPixmapItem(QGraphicsItem * parent = 0)

Constructs aQGraphicsPixmapItem.parent is passed toQGraphicsItem's constructor.

See alsoQGraphicsScene::addItem().

QGraphicsPixmapItem::QGraphicsPixmapItem(constQPixmap & pixmap,QGraphicsItem * parent = 0)

Constructs aQGraphicsPixmapItem, usingpixmap as the default pixmap.parent is passed toQGraphicsItem's constructor.

See alsoQGraphicsScene::addItem().

QGraphicsPixmapItem::~QGraphicsPixmapItem()

Destroys theQGraphicsPixmapItem.

[virtual]QRectF QGraphicsPixmapItem::boundingRect() const

Reimplemented fromQGraphicsItem::boundingRect().

[virtual]bool QGraphicsPixmapItem::contains(constQPointF & point) const

Reimplemented fromQGraphicsItem::contains().

[virtual]bool QGraphicsPixmapItem::isObscuredBy(constQGraphicsItem * item) const

Reimplemented fromQGraphicsItem::isObscuredBy().

QPointF QGraphicsPixmapItem::offset() const

Returns the pixmap item'soffset, which defines the point of the top-left corner of the pixmap, in local coordinates.

See alsosetOffset().

[virtual]QPainterPath QGraphicsPixmapItem::opaqueArea() const

Reimplemented fromQGraphicsItem::opaqueArea().

[virtual]void QGraphicsPixmapItem::paint(QPainter * painter, constQStyleOptionGraphicsItem * option,QWidget * widget)

Reimplemented fromQGraphicsItem::paint().

QPixmap QGraphicsPixmapItem::pixmap() const

Returns the item's pixmap, or an invalidQPixmap if no pixmap has been set.

See alsosetPixmap().

void QGraphicsPixmapItem::setOffset(constQPointF & offset)

Sets the pixmap item's offset tooffset.QGraphicsPixmapItem will draw its pixmap usingoffset for its top-left corner.

See alsooffset().

void QGraphicsPixmapItem::setOffset(qreal x,qreal y)

This convenience function is equivalent to callingsetOffset(QPointF(x,y)).

This function was introduced in Qt 4.3.

void QGraphicsPixmapItem::setPixmap(constQPixmap & pixmap)

Sets the item's pixmap topixmap.

See alsopixmap().

void QGraphicsPixmapItem::setShapeMode(ShapeMode mode)

Sets the item's shape mode tomode. The shape mode describes howQGraphicsPixmapItem calculates its shape. The default mode isMaskShape.

See alsoshapeMode() andShapeMode.

void QGraphicsPixmapItem::setTransformationMode(Qt::TransformationMode mode)

Sets the pixmap item's transformation mode tomode, and toggles an update of the item. The default mode isQt::FastTransformation, which provides quick transformation with no smoothing.

Qt::SmoothTransformation enablesQPainter::SmoothPixmapTransform on the painter, and the quality depends on the platform and viewport. The result is usually not as good as calling QPixmap::scale() directly.

See alsotransformationMode().

[virtual]QPainterPath QGraphicsPixmapItem::shape() const

Reimplemented fromQGraphicsItem::shape().

ShapeMode QGraphicsPixmapItem::shapeMode() const

Returns the item's shape mode. The shape mode describes howQGraphicsPixmapItem calculates its shape. The default mode isMaskShape.

See alsosetShapeMode() andShapeMode.

Qt::TransformationMode QGraphicsPixmapItem::transformationMode() const

Returns the transformation mode of the pixmap. The default mode isQt::FastTransformation, which provides quick transformation with no smoothing.

See alsosetTransformationMode().

[virtual]int QGraphicsPixmapItem::type() const

Reimplemented fromQGraphicsItem::type().