En esta página

QGraphicsScale Class

La clase QGraphicsScale proporciona una transformación de escala. Más información...

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

Propiedades

Funciones públicas

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

Funciones públicas reimplementadas

virtual void applyTo(QMatrix4x4 *matrix) const override

Señales

Descripción detallada

QGraphicsScene proporciona ciertos parámetros para ayudar a controlar cómo debe aplicarse el escalado.

El origen es el punto a partir del cual se escala el elemento (es decir, permanece fijo con respecto al elemento padre mientras el resto del elemento crece). Por defecto, el origen es QPointF(0, 0).

Los parámetros xScale, yScale y zScale describen los factores de escala que se deben aplicar en las direcciones horizontal, vertical y de profundidad. Pueden adoptar cualquier valor, incluido 0 (para reducir el elemento a un punto) o un valor negativo. Un valor negativo de xScale reflejará el elemento horizontalmente. Un valor negativo de yScale volteará el elemento verticalmente. Un valor negativo de zScale volteará el elemento de extremo a extremo.

Véase también QGraphicsTransform, QGraphicsItem::setScale() y QTransform::scale().

Documentación de propiedades

origin : QVector3D

Esta propiedad define el origen de la escala en el espacio 3D.

Todo el escalado se realizará con respecto a este punto (es decir, este punto permanecerá fijo, con respecto al elemento padre, cuando se escale el elemento).

Funciones de acceso:

QVector3D origin() const
void setOrigin(const QVector3D &point)

Señal de notificación:

void originChanged()

Véase también xScale, yScale y zScale.

xScale : qreal

Esta propiedad contiene el factor de escala horizontal.

El factor de escala puede ser cualquier número real; el valor por defecto es 1,0. Si se establece el factor en 0,0, el elemento se reducirá a un único punto. Si se introduce un valor negativo, el elemento se reflejará horizontalmente respecto a su origen.

Funciones de acceso:

qreal xScale() const
void setXScale(qreal)

Señal de notificación:

void xScaleChanged()

Véase también « yScale », « zScale » y «origin».

yScale : qreal

Esta propiedad contiene el factor de escala vertical.

El factor de escala puede ser cualquier número real; el valor por defecto es 1,0. Si se establece el factor en 0,0, el elemento se reducirá a un único punto. Si se especifica un valor negativo, el elemento se invertirá verticalmente alrededor de su origen.

Funciones de acceso:

qreal yScale() const
void setYScale(qreal)

Señal de notificación:

void yScaleChanged()

Véase también « xScale », « zScale » y «origin».

zScale : qreal

Esta propiedad contiene el factor de escala de profundidad.

El factor de escala puede ser cualquier número real; el valor por defecto es 1,0. Si se establece el factor en 0,0, el elemento se reducirá a un único punto. Si se introduce un valor negativo, el elemento se invertirá de extremo a extremo alrededor de su origen.

Funciones de acceso:

qreal zScale() const
void setZScale(qreal)

Señal de notificación:

void zScaleChanged()

Véase también « xScale », « yScale » y «origin».

Documentación de funciones de miembro

QGraphicsScale::QGraphicsScale(QObject *parent = nullptr)

Crea un objeto `QGraphicsScale` vacío con el ` parent` especificado.

[virtual noexcept] QGraphicsScale::~QGraphicsScale()

Altera la escala de los gráficos.

[override virtual] void QGraphicsScale::applyTo(QMatrix4x4 *matrix) const

Reimplementa: QGraphicsTransform::applyTo(QMatrix4x4 *matrix) const.

[signal] void QGraphicsScale::originChanged()

QGraphicsScale Emite esta señal cuando cambia su origen.

Nota: Señalde notificador para la propiedad «origin».

Véase también QGraphicsScale::origin.

[signal] void QGraphicsScale::scaleChanged()

Esta señal se emite cada vez que cambia el xScale, yScale o zScale del objeto.

Véase también QGraphicsScale::xScale, QGraphicsScale::yScale y QGraphicsScale::zScale.

[signal] void QGraphicsScale::xScaleChanged()

Esta señal se emite cada vez que cambia la propiedad xScale.

Nota: Señalde notificación para la propiedad xScale.

[signal] void QGraphicsScale::yScaleChanged()

Esta señal se emite cada vez que cambia la propiedad yScale.

Nota: Señalde notificación para la propiedad yScale.

[signal] void QGraphicsScale::zScaleChanged()

Esta señal se emite cada vez que cambia la propiedad zScale.

Nota: Señalde notificador para la propiedad 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.