Материал из Wiki.crossplatform.ru

Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

[править] QGraphicsPixmapItem Class Reference
^{[модуль QtGui ]}

The QGraphicsPixmapItem class provides a pixmap item that you can add to a QGraphicsScene. Далее...

 #include <QGraphicsPixmapItem>

Inherits QGraphicsItem.

Класс был добавлен в Qt 4.2.

• Список всех членов, включая унаследованные

[править] Открытые типы

• enum ShapeMode { MaskShape, BoundingRectShape, HeuristicMaskShape }

[править] Открытые функции

• QGraphicsPixmapItem ( QGraphicsItem * parent = 0 )
• QGraphicsPixmapItem ( const QPixmap & pixmap, QGraphicsItem * parent = 0 )
• ~QGraphicsPixmapItem ()
• QPointF offset () const
• QPixmap pixmap () const
• void setOffset ( const QPointF & offset )
• void setOffset ( qreal x, qreal y )
• void setPixmap ( const QPixmap & pixmap )
• void setShapeMode ( ShapeMode mode )
• void setTransformationMode ( Qt::TransformationMode mode )
• ShapeMode shapeMode () const
• Qt::TransformationMode transformationMode () const

• 114 public functions inherited from QGraphicsItem

[править] Дополнительные унаследованные члены

• 1 static public member inherited from QGraphicsItem
• 23 protected functions inherited from QGraphicsItem

[править] Подробное описание

The QGraphicsPixmapItem class provides a pixmap item that you can add to a QGraphicsScene.

To set the item's pixmap, pass a QPixmap to QGraphicsPixmapItem's constructor, or call the setPixmap() function. The pixmap() function returns the current pixmap.

QGraphicsPixmapItem uses pixmap's optional alpha mask to provide a reasonable implementation of boundingRect(), shape(), and contains().

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

You can set the pixmap's transformation mode by calling setTransformationMode(). By default, Qt::FastTransformation is used, which provides fast, non-smooth scaling. Qt::SmoothTransformation enables QPainter::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. Call transformationMode() to get the current transformation mode for the item.

See also QGraphicsPathItem, QGraphicsRectItem, QGraphicsEllipseItem, QGraphicsTextItem, QGraphicsPolygonItem, QGraphicsLineItem, and The Graphics View Framework.

[править] Описание типов

[править]

enum QGraphicsPixmapItem::ShapeMode

This enum describes how QGraphicsPixmapItem calculates its shape.

The default value is MaskShape.

[править] Описание функций-членов

[править]

QGraphicsPixmapItem::QGraphicsPixmapItem ( QGraphicsItem * parent = 0 )

Constructs a QGraphicsPixmapItem. parent is passed to QGraphicsItem's constructor.

See also QGraphicsScene::addItem().

[править]

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

Constructs a QGraphicsPixmapItem, using pixmap as the default pixmap. parent is passed to QGraphicsItem's constructor.

See also QGraphicsScene::addItem().

[править]

QGraphicsPixmapItem::~QGraphicsPixmapItem ()

Destroys the QGraphicsPixmapItem.

[править]

QPointF QGraphicsPixmapItem::offset () const

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

See also setOffset().

[править]

QPixmap QGraphicsPixmapItem::pixmap () const

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

Смотрите также setPixmap().

[править]

void QGraphicsPixmapItem::setOffset ( const QPointF & offset )

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

See also offset().

[править]

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

Эта перегруженная функция предоставлена для удобства.

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

Эта функция была введена в Qt 4.3.

[править]

void QGraphicsPixmapItem::setPixmap ( const QPixmap & pixmap )

Sets the item's pixmap to pixmap.

Смотрите также pixmap().

[править]

void QGraphicsPixmapItem::setShapeMode ( ShapeMode mode )

Sets the item's shape mode to mode. The shape mode describes how QGraphicsPixmapItem calculates its shape. The default mode is MaskShape.

See also shapeMode() and ShapeMode.

[править]

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

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

Qt::SmoothTransformation enables QPainter::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 also transformationMode().

[править]

ShapeMode QGraphicsPixmapItem::shapeMode () const

Returns the item's shape mode. The shape mode describes how QGraphicsPixmapItem calculates its shape. The default mode is MaskShape.

See also setShapeMode() and ShapeMode.

[править]

Qt::TransformationMode QGraphicsPixmapItem::transformationMode () const

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

See also setTransformationMode().