QGraphicsPixmapItem Class
La classe QGraphicsPixmapItem fournit un élément de pixmap que vous pouvez ajouter à un site QGraphicsScene. Plus....
| En-tête : | #include <QGraphicsPixmapItem> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Héritages : | QGraphicsItem |
Types publics
Fonctions publiques
| 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 |
Fonctions publiques réimplémentées
| 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 |
Description détaillée
Pour définir la pixmap de l'élément, passez une adresse QPixmap au constructeur de QGraphicsPixmapItem ou appelez la fonction setPixmap(). La fonction pixmap() renvoie la pixmap actuelle.
QGraphicsPixmapItem utilise le masque alpha facultatif de pixmap pour fournir une implémentation raisonnable de boundingRect(), shape() et contains().
La pixmap est dessinée à la coordonnée (0, 0) de l'élément, telle que renvoyée par offset(). Vous pouvez modifier le décalage de dessin en appelant setOffset().
Vous pouvez définir le mode de transformation de la pixmap en appelant setTransformationMode(). Par défaut, Qt::FastTransformation est utilisé, ce qui permet une mise à l'échelle rapide et non lisse. Qt::SmoothTransformation active QPainter::SmoothPixmapTransform sur le peintre, et la qualité dépend de la plate-forme et de la fenêtre. Le résultat n'est généralement pas aussi bon qu'en appelant directement QPixmap::scale(). Appelez transformationMode() pour obtenir le mode de transformation actuel de l'élément.
Voir aussi QGraphicsPathItem, QGraphicsRectItem, QGraphicsEllipseItem, QGraphicsTextItem, QGraphicsPolygonItem, QGraphicsLineItem, et Graphics View Framework.
Documentation sur les types de membres
enum QGraphicsPixmapItem::ShapeMode
Cette énumération décrit la manière dont QGraphicsPixmapItem calcule sa forme et sa zone opaque.
La valeur par défaut est MaskShape.
| Constante | Valeur | Description |
|---|---|---|
QGraphicsPixmapItem::MaskShape | 0 | La forme est déterminée en appelant QPixmap::mask(). Cette forme n'inclut que les pixels opaques de la pixmap. La forme étant plus complexe, elle peut être plus lente que les autres modes et utilise plus de mémoire. |
QGraphicsPixmapItem::BoundingRectShape | 1 | La forme est déterminée en traçant le contour de la pixmap. C'est le mode le plus rapide, mais il ne prend pas en compte les zones transparentes de la pixmap. |
QGraphicsPixmapItem::HeuristicMaskShape | 2 | La forme est déterminée en appelant QPixmap::createHeuristicMask(). Les performances et la consommation de mémoire sont similaires à celles de MaskShape. |
[anonymous] enum
Valeur retournée par la fonction virtuelle type().
| Constante | Valeur | Description de la constante |
|---|---|---|
QGraphicsPixmapItem::Type | 7 | Un élément de pixmap graphique |
Documentation des fonctions membres
[explicit] QGraphicsPixmapItem::QGraphicsPixmapItem(QGraphicsItem *parent = nullptr)
Construit un élément QGraphicsPixmap. parent est transmis au constructeur de QGraphicsItem.
Voir aussi QGraphicsScene::addItem().
[explicit] QGraphicsPixmapItem::QGraphicsPixmapItem(const QPixmap &pixmap, QGraphicsItem *parent = nullptr)
Construit un élément QGraphicsPixmapItem, en utilisant pixmap comme pixmap par défaut. parent est transmis au constructeur de QGraphicsItem.
Voir aussi QGraphicsScene::addItem().
[virtual noexcept] QGraphicsPixmapItem::~QGraphicsPixmapItem()
Détruit le site QGraphicsPixmapItem.
[override virtual] QRectF QGraphicsPixmapItem::boundingRect() const
Réimplémente : QGraphicsItem::boundingRect() const.
[override virtual] bool QGraphicsPixmapItem::contains(const QPointF &point) const
Réimplémente : QGraphicsItem::contains(const QPointF &point) const.
[override virtual] bool QGraphicsPixmapItem::isObscuredBy(const QGraphicsItem *item) const
Réimplémente : QGraphicsItem::isObscuredBy(const QGraphicsItem *item) const.
QPointF QGraphicsPixmapItem::offset() const
Renvoie le décalage de l'élément de la pixmap, qui définit le point du coin supérieur gauche de la pixmap, en coordonnées locales.
Voir aussi setOffset().
[override virtual] QPainterPath QGraphicsPixmapItem::opaqueArea() const
Réimplémente : QGraphicsItem::opaqueArea() const.
[override virtual] void QGraphicsPixmapItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)
Réimplémente : QGraphicsItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget).
QPixmap QGraphicsPixmapItem::pixmap() const
Renvoie la pixmap de l'élément, ou une adresse QPixmap invalide si aucune pixmap n'a été définie.
Voir également setPixmap().
void QGraphicsPixmapItem::setOffset(const QPointF &offset)
Définit le décalage de l'élément pixmap à offset. QGraphicsPixmapItem dessinera son pixmap en utilisant offset pour son coin supérieur gauche.
Voir aussi offset().
void QGraphicsPixmapItem::setOffset(qreal x, qreal y)
Cette fonction de commodité équivaut à appeler setOffset(QPointF(x, y)).
void QGraphicsPixmapItem::setPixmap(const QPixmap &pixmap)
Définit la pixmap de l'élément à pixmap.
Voir aussi pixmap().
void QGraphicsPixmapItem::setShapeMode(QGraphicsPixmapItem::ShapeMode mode)
Définit le mode de forme de l'élément sur mode. Le mode de forme décrit la manière dont QGraphicsPixmapItem calcule sa forme. Le mode par défaut est MaskShape.
Voir également shapeMode() et ShapeMode.
void QGraphicsPixmapItem::setTransformationMode(Qt::TransformationMode mode)
Définit le mode de transformation de l'élément pixmap à mode, et active la mise à jour de l'élément. Le mode par défaut est Qt::FastTransformation, qui permet une transformation rapide sans lissage.
Qt::SmoothTransformation active QPainter::SmoothPixmapTransform sur le peintre, et la qualité dépend de la plateforme et du viewport. Le résultat n'est généralement pas aussi bon que d'appeler QPixmap::scale() directement.
Voir aussi transformationMode().
[override virtual] QPainterPath QGraphicsPixmapItem::shape() const
Réimplémente : QGraphicsItem::shape() const.
QGraphicsPixmapItem::ShapeMode QGraphicsPixmapItem::shapeMode() const
Renvoie le mode de forme de l'élément. Le mode de forme décrit la manière dont QGraphicsPixmapItem calcule sa forme. Le mode par défaut est MaskShape.
Voir également setShapeMode() et ShapeMode.
Qt::TransformationMode QGraphicsPixmapItem::transformationMode() const
Renvoie le mode de transformation de la pixmap. Le mode par défaut est Qt::FastTransformation, qui permet une transformation rapide sans lissage.
Voir aussi setTransformationMode().
[override virtual] int QGraphicsPixmapItem::type() const
Réimplémente : 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.
