QGraphicsPixmapItem Class
La clase QGraphicsPixmapItem proporciona un elemento pixmap que se puede añadir a un QGraphicsScene. Más...
| Cabecera: | #include <QGraphicsPixmapItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Hereda: | QGraphicsItem |
Tipos Públicos
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 pixmap del elemento, pasa un QPixmap al constructor de QGraphicsPixmapItem, o llama a la función setPixmap(). La función pixmap() devuelve el pixmap actual.
QGraphicsPixmapItem utiliza la máscara alfa opcional de pixmap para proporcionar una implementación razonable de boundingRect(), shape(), y contains().
El mapa de píxeles se dibuja en la coordenada (0, 0) del elemento, devuelta por offset(). Puedes cambiar el offset de dibujado llamando a setOffset().
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 y no suave. Qt::SmoothTransformation activa QPainter::SmoothPixmapTransform en el pintor, y la calidad depende de la plataforma y la ventana gráfica. El resultado no suele ser tan bueno como llamar directamente a QPixmap::scale(). Llame a transformationMode() para obtener el modo de transformación actual del elemento.
Ver también QGraphicsPathItem, QGraphicsRectItem, QGraphicsEllipseItem, QGraphicsTextItem, QGraphicsPolygonItem, QGraphicsLineItem, y Graphics View Framework.
Documentación de tipos de miembros
enum QGraphicsPixmapItem::ShapeMode
Este enum describe cómo QGraphicsPixmapItem calcula su forma y área opaca.
El valor por defecto es MaskShape.
| Constante | Valor | Descripción |
|---|---|---|
QGraphicsPixmapItem::MaskShape | 0 | La forma se determina llamando a QPixmap::mask(). Esta forma incluye sólo los píxeles opacos del mapa de píxeles. Debido a que la forma es más compleja, sin embargo, puede ser más lenta que los otros modos, y utiliza más memoria. |
QGraphicsPixmapItem::BoundingRectShape | 1 | La forma se determina trazando el contorno del mapa de píxeles. Es el modo de forma más rápido, pero no tiene en cuenta las áreas transparentes del mapa de píxeles. |
QGraphicsPixmapItem::HeuristicMaskShape | 2 | La forma se determina llamando a QPixmap::createHeuristicMask(). El rendimiento y el consumo de memoria son similares a MaskShape. |
[anonymous] enum
El valor devuelto por la función virtual type().
| Constante | Valor | Descripción |
|---|---|---|
QGraphicsPixmapItem::Type | 7 | Un elemento gráfico pixmap |
Documentación de la función miembro
[explicit] QGraphicsPixmapItem::QGraphicsPixmapItem(QGraphicsItem *parent = nullptr)
Construye un QGraphicsPixmapItem. parent se pasa al constructor de QGraphicsItem.
Ver también QGraphicsScene::addItem().
[explicit] QGraphicsPixmapItem::QGraphicsPixmapItem(const QPixmap &pixmap, QGraphicsItem *parent = nullptr)
Construye un QGraphicsPixmapItem, usando pixmap como pixmap por defecto. parent se pasa al constructor de QGraphicsItem.
Ver 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 el punto 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 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 a offset. QGraphicsPixmapItem dibujará su pixmap usando offset para su esquina superior izquierda.
Véase también offset().
void QGraphicsPixmapItem::setOffset(qreal x, qreal y)
Esta función es equivalente 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 por defecto 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 una actualización del elemento. El modo por defecto 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 del viewport. El resultado no suele ser tan bueno como 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 QGraphicsPixmapItem calcula su forma. El modo por defecto 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 por defecto es Qt::FastTransformation, que proporciona 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.
