QGraphicsPixmapItem Class
La classe `QGraphicsPixmapItem` fournit un élément pixmap que vous pouvez ajouter à un ` QGraphicsScene`. En savoir plus...
| En-tête : | #include <QGraphicsPixmapItem> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite de : | 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 le pixmap de l'élément, transmettez un objet ` QPixmap ` au constructeur de `QGraphicsPixmapItem`, ou appelez la fonction ` setPixmap()`. La fonction ` pixmap()` renvoie le pixmap actuel.
QGraphicsPixmapItem utilise le masque alpha facultatif de la pixmap pour fournir une implémentation raisonnable des fonctions boundingRect(), shape() et contains().
Le pixmap est dessiné aux coordonnées (0, 0) de l’élément, telles que renvoyées 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 fournit une mise à l'échelle rapide mais non lisse. Qt::SmoothTransformation active la fonction « QPainter::SmoothPixmapTransform » sur le peintre, et la qualité dépend de la plate-forme et de la fenêtre d'affichage. Le résultat n'est généralement pas aussi bon que lorsque l'on appelle directement QPixmap::scale(). Appelez ` transformationMode()` pour obtenir le mode de transformation actuel de l’élément.
Voir également 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 surface opaque.
La valeur par défaut est MaskShape.
| Constante | Valeur | Description |
|---|---|---|
QGraphicsPixmapItem::MaskShape | 0 | La forme est déterminée en appelant la fonction QPixmap::mask(). Cette forme n’inclut que les pixels opaques de la carte de pixels. Cependant, comme la forme est plus complexe, ce mode peut être plus lent que les autres et utilise davantage de mémoire. |
QGraphicsPixmapItem::BoundingRectShape | 1 | La forme est déterminée en traçant le contour de l'image. Il s'agit du mode de forme le plus rapide, mais il ne tient pas compte des zones transparentes de l'image. |
QGraphicsPixmapItem::HeuristicMaskShape | 2 | La forme est déterminée en appelant la fonction ` QPixmap::createHeuristicMask()`. Les performances et la consommation de mémoire sont similaires à celles du mode `MaskShape`. |
[anonymous] enum
Valeur renvoyée par la fonction virtuelle ` type()`.
| Constante | Valeur | Description |
|---|---|---|
QGraphicsPixmapItem::Type | 7 | Un élément de carte de pixels graphique |
Documentation des fonctions membres
[explicit] QGraphicsPixmapItem::QGraphicsPixmapItem(QGraphicsItem *parent = nullptr)
Crée un objet `QGraphicsPixmapItem`. L'objet ` parent ` est transmis au constructeur de ` QGraphicsItem`.
Voir aussi QGraphicsScene::addItem().
[explicit] QGraphicsPixmapItem::QGraphicsPixmapItem(const QPixmap &pixmap, QGraphicsItem *parent = nullptr)
Crée un objet `QGraphicsPixmapItem` en utilisant ` pixmap ` comme image par défaut. ` parent ` est transmis au constructeur de ` QGraphicsItem`.
Voir aussi QGraphicsScene::addItem().
[virtual noexcept] QGraphicsPixmapItem::~QGraphicsPixmapItem()
Supprime l'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 pixmap, qui définit la position du coin supérieur gauche de la pixmap, en coordonnées locales.
Voir également ` 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 carte de pixels de l'élément, ou un objet ` QPixmap ` non valide si aucune carte de pixels n'a été définie.
Voir aussi setPixmap().
void QGraphicsPixmapItem::setOffset(const QPointF &offset)
Définit le décalage de l'élément pixmap sur offset. QGraphicsPixmapItem dessinera son pixmap en utilisant offset comme coin supérieur gauche.
Voir également offset().
void QGraphicsPixmapItem::setOffset(qreal x, qreal y)
Cette fonction pratique revient à appeler setOffset(QPointF(x, y)).
void QGraphicsPixmapItem::setPixmap(const QPixmap &pixmap)
Définit le pixmap de l'élément sur pixmap.
Voir également 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 sur « mode » et active ou désactive 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 la fonction « QPainter::SmoothPixmapTransform » sur le peintre ; la qualité dépend de la plate-forme et de la fenêtre d’affichage. Le résultat n’est généralement pas aussi bon que lorsque l’on appelle directement QPixmap::scale().
Voir également 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 aussi setShapeMode() et ShapeMode.
Qt::TransformationMode QGraphicsPixmapItem::transformationMode() const
Renvoie le mode de transformation de la carte de pixels. 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.
