En esta página

QGraphicsPixmapItem Class

La clase `QGraphicsPixmapItem` proporciona un elemento de mapa de píxeles que se puede añadir a un ` QGraphicsScene`. Más información...

Encabezado: #include <QGraphicsPixmapItem>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredan: QGraphicsItem

Tipos públicos

enum ShapeMode { MaskShape, BoundingRectShape, HeuristicMaskShape }
enum { Type }

Funciones públicas

QGraphicsPixmapItem(QGraphicsItem *parent = nullptr)
QGraphicsPixmapItem(const QPixmap &pixmap, QGraphicsItem *parent = nullptr)
virtual ~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(QGraphicsPixmapItem::ShapeMode mode)
void setTransformationMode(Qt::TransformationMode mode)
QGraphicsPixmapItem::ShapeMode shapeMode() const
Qt::TransformationMode transformationMode() const

Funciones públicas reimplementadas

virtual QRectF boundingRect() const override
virtual bool contains(const QPointF &point) const override
virtual bool isObscuredBy(const QGraphicsItem *item) const override
virtual QPainterPath opaqueArea() const override
virtual void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget) override
virtual QPainterPath shape() const override
virtual int type() const override

Descripción detallada

Para establecer el mapa de píxeles del elemento, pasa un objeto ` QPixmap ` al constructor de `QGraphicsPixmapItem` o llama a la función ` setPixmap()`. La función ` pixmap()` devuelve el mapa de píxeles actual.

QGraphicsPixmapItem utiliza la máscara alfa opcional del mapa de píxeles para proporcionar una implementación razonable de boundingRect(), shape() y contains().

Imagen rasterizada del logotipo de Qt dibujada cerca del origen

El mapa de píxeles se dibuja en la coordenada (0, 0) del elemento, tal y como devuelve offset(). Se puede modificar el desplazamiento de dibujo llamando a setOffset().

Se puede establecer el modo de transformación del mapa de píxeles llamando a ` setTransformationMode()`. Por defecto, se utiliza ` Qt::FastTransformation `, que proporciona un escalado rápido pero no suave. ` Qt::SmoothTransformation ` habilita ` QPainter::SmoothPixmapTransform ` en el pintor, y la calidad depende de la plataforma y de la ventana gráfica. El resultado no suele ser tan bueno como al llamar directamente a `QPixmap::scale()`. Llama a transformationMode() para obtener el modo de transformación actual del elemento.

Véase también QGraphicsPathItem, QGraphicsRectItem, QGraphicsEllipseItem, QGraphicsTextItem, QGraphicsPolygonItem, QGraphicsLineItem y Graphics View Framework.

Documentación sobre los tipos de miembros

enum QGraphicsPixmapItem::ShapeMode

Esta enumeración describe cómo calcula « QGraphicsPixmapItem » su forma y su área opaca.

El valor por defecto es MaskShape.

ConstanteValorDescripción
QGraphicsPixmapItem::MaskShape0La forma se determina llamando a QPixmap::mask(). Esta forma incluye únicamente los píxeles opacos del mapa de píxeles. Sin embargo, dado que la forma es más compleja, puede resultar más lenta que los demás modos y consume más memoria.
QGraphicsPixmapItem::BoundingRectShape1La forma se determina trazando el contorno del mapa de píxeles. Este es el modo de forma más rápido, pero no tiene en cuenta las áreas transparentes del mapa de píxeles.
QGraphicsPixmapItem::HeuristicMaskShape2La forma se determina llamando a QPixmap::createHeuristicMask(). El rendimiento y el consumo de memoria son similares a los de MaskShape.

[anonymous] enum

El valor devuelto por la función virtual ` type()`.

ConstanteValorDescripción
QGraphicsPixmapItem::Type7Un elemento de mapa de píxeles gráfico

Documentación de la función miembro

[explicit] QGraphicsPixmapItem::QGraphicsPixmapItem(QGraphicsItem *parent = nullptr)

Crea un objeto `QGraphicsPixmapItem`. Se pasa ` parent ` al constructor de ` QGraphicsItem`.

Véase también QGraphicsScene::addItem().

[explicit] QGraphicsPixmapItem::QGraphicsPixmapItem(const QPixmap &pixmap, QGraphicsItem *parent = nullptr)

Crea un objeto `QGraphicsPixmapItem` utilizando ` pixmap ` como mapa de píxeles por defecto. Se pasa ` parent ` al constructor de ` QGraphicsItem`.

Véase también QGraphicsScene::addItem().

[virtual noexcept] QGraphicsPixmapItem::~QGraphicsPixmapItem()

Destruye el « QGraphicsPixmapItem ».

[override virtual] QRectF QGraphicsPixmapItem::boundingRect() const

Reimplementa: ` QGraphicsItem::boundingRect()` const.

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

Reimplementa: QGraphicsItem::contains(const QPointF &point) const.

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

Reimplementa: QGraphicsItem::isObscuredBy(const QGraphicsItem *item) const.

QPointF QGraphicsPixmapItem::offset() const

Devuelve el desplazamiento del elemento pixmap, que define la posición de la esquina superior izquierda del pixmap en coordenadas locales.

Véase también setOffset().

[override virtual] QPainterPath QGraphicsPixmapItem::opaqueArea() const

Reimplementa: ` QGraphicsItem::opaqueArea()` const.

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

Reimplementa: ` QGraphicsItem::paint` (`QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)`.

QPixmap QGraphicsPixmapItem::pixmap() const

Devuelve el mapa de píxeles del elemento o un objeto ` QPixmap ` no válido si no se ha establecido ningún mapa de píxeles.

Véase también setPixmap().

void QGraphicsPixmapItem::setOffset(const QPointF &offset)

Establece el desplazamiento del elemento pixmap en offset. QGraphicsPixmapItem dibujará su pixmap utilizando offset como esquina superior izquierda.

Véase también offset().

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

Esta función de conveniencia equivale a llamar a setOffset(QPointF(x, y)).

void QGraphicsPixmapItem::setPixmap(const QPixmap &pixmap)

Establece el mapa de píxeles del elemento en pixmap.

Véase también pixmap().

void QGraphicsPixmapItem::setShapeMode(QGraphicsPixmapItem::ShapeMode mode)

Establece el modo de forma del elemento en « mode ». El modo de forma describe cómo « QGraphicsPixmapItem » calcula su forma. El modo predeterminado es « MaskShape ».

Véase también « shapeMode()» y « ShapeMode ».

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

Establece el modo de transformación del elemento pixmap en « mode » y activa o desactiva la actualización del elemento. El modo predeterminado es « Qt::FastTransformation », que proporciona una transformación rápida sin suavizado.

Qt::SmoothTransformation Habilita « QPainter::SmoothPixmapTransform » en el pintor, y la calidad depende de la plataforma y de la ventana gráfica. El resultado no suele ser tan bueno como al llamar directamente a QPixmap::scale().

Véase también transformationMode().

[override virtual] QPainterPath QGraphicsPixmapItem::shape() const

Reimplementa: QGraphicsItem::shape() const.

QGraphicsPixmapItem::ShapeMode QGraphicsPixmapItem::shapeMode() const

Devuelve el modo de forma del elemento. El modo de forma describe cómo calcula su forma QGraphicsPixmapItem. El modo predeterminado es MaskShape.

Véase también setShapeMode() y ShapeMode.

Qt::TransformationMode QGraphicsPixmapItem::transformationMode() const

Devuelve el modo de transformación del mapa de píxeles. El modo predeterminado es « Qt::FastTransformation », que permite una transformación rápida sin suavizado.

Véase también setTransformationMode().

[override virtual] int QGraphicsPixmapItem::type() const

Reimplementa: ` QGraphicsItem::type()` const.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.