QGraphicsScale Class
La classe QGraphicsScale permet d'effectuer une transformation d'échelle. En savoir plus...
| En-tête : | #include <QGraphicsScale> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite de : | QGraphicsTransform |
Propriétés
Fonctions publiques
| QGraphicsScale(QObject *parent = nullptr) | |
| virtual | ~QGraphicsScale() |
| QVector3D | origin() const |
| void | setOrigin(const QVector3D &point) |
| void | setXScale(qreal) |
| void | setYScale(qreal) |
| void | setZScale(qreal) |
| qreal | xScale() const |
| qreal | yScale() const |
| qreal | zScale() const |
Fonctions publiques réimplémentées
| virtual void | applyTo(QMatrix4x4 *matrix) const override |
Signaux
| void | originChanged() |
| void | scaleChanged() |
| void | xScaleChanged() |
| void | yScaleChanged() |
| void | zScaleChanged() |
Description détaillée
QGraphicsScene fournit certains paramètres permettant de contrôler la manière dont la mise à l'échelle doit être appliquée.
L'origine est le point à partir duquel l'élément est mis à l'échelle (c'est-à-dire qu'il reste fixe par rapport à son parent tandis que le reste de l'élément s'agrandit). Par défaut, l'origine est QPointF(0, 0).
Les paramètres xScale, yScale et zScale décrivent les facteurs d’échelle à appliquer respectivement dans les directions horizontale, verticale et de profondeur. Ils peuvent prendre n’importe quelle valeur, y compris 0 (pour réduire l’élément à un point) ou une valeur négative. Une valeur négative pour xScale inversera l’élément horizontalement. Une valeur négative pour yScale inversera l’élément verticalement. Une valeur négative pour zScale inversera l’élément de bout en bout.
Voir également QGraphicsTransform, QGraphicsItem::setScale() et QTransform::scale().
Documentation sur les propriétés
origin : QVector3D
Cette propriété définit l'origine de la mise à l'échelle dans l'espace 3D.
Toutes les mises à l'échelle s'effectuent par rapport à ce point (c'est-à-dire que ce point reste fixe par rapport à l'élément parent lorsque l'élément est mis à l'échelle).
Fonctions d'accès :
| QVector3D | origin() const |
| void | setOrigin(const QVector3D &point) |
Signal de notification :
| void | originChanged() |
Voir également xScale, yScale et zScale.
xScale : qreal
Cette propriété définit le facteur d'échelle horizontal.
Le facteur d’échelle peut être n’importe quel nombre réel ; la valeur par défaut est 1,0. Si vous définissez ce facteur sur 0,0, l’élément sera réduit à un simple point. Si vous indiquez une valeur négative, l’élément sera reflété horizontalement par rapport à son origine.
Fonctions d'accès :
| qreal | xScale() const |
| void | setXScale(qreal) |
Signal de notification :
| void | xScaleChanged() |
Voir également yScale, zScale et origin.
yScale : qreal
Cette propriété définit le facteur d'échelle vertical.
Le facteur d'échelle peut être n'importe quel nombre réel ; la valeur par défaut est 1,0. Si vous définissez ce facteur sur 0,0, l'élément sera réduit à un simple point. Si vous indiquez une valeur négative, l'élément sera inversé verticalement par rapport à son origine.
Fonctions d'accès :
| qreal | yScale() const |
| void | setYScale(qreal) |
Signal de notification :
| void | yScaleChanged() |
Voir également xScale, zScale et origin.
zScale : qreal
Cette propriété définit le facteur d'échelle de profondeur.
Le facteur d'échelle peut être n'importe quel nombre réel ; la valeur par défaut est 1,0. Si vous définissez ce facteur sur 0,0, l'élément sera réduit à un simple point. Si vous indiquez une valeur négative, l'élément sera inversé par rapport à son origine.
Fonctions d'accès :
| qreal | zScale() const |
| void | setZScale(qreal) |
Signal de notification :
| void | zScaleChanged() |
Documentation des fonctions membres
QGraphicsScale::QGraphicsScale(QObject *parent = nullptr)
Crée un objet QGraphicsScale vide avec l'parent on fournie.
[virtual noexcept] QGraphicsScale::~QGraphicsScale()
Cela perturbe l'échelle graphique.
[override virtual] void QGraphicsScale::applyTo(QMatrix4x4 *matrix) const
Réimplémentation de : QGraphicsTransform::applyTo(QMatrix4x4 *matrix) const.
[signal] void QGraphicsScale::originChanged()
QGraphicsScale émet ce signal lorsque l'origine de la propriété change.
Remarque : signalde notification pour la propriété « origin ».
Voir également QGraphicsScale::origin.
[signal] void QGraphicsScale::scaleChanged()
Ce signal est émis chaque fois que la propriété « xScale », « yScale » ou « zScale » de l'objet change.
Voir également QGraphicsScale::xScale, QGraphicsScale::yScale et QGraphicsScale::zScale.
[signal] void QGraphicsScale::xScaleChanged()
Ce signal est émis chaque fois que la propriété xScale change.
Remarque : signalde notification pour la propriété xScale.
[signal] void QGraphicsScale::yScaleChanged()
Ce signal est émis chaque fois que la propriété « yScale » change.
Remarque : signalde notification pour la propriété yScale.
[signal] void QGraphicsScale::zScaleChanged()
Ce signal est émis chaque fois que la propriété zScale change.
Remarque : signalde notification pour la propriété zScale.
© 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.
