En esta página

QGraphicsObject Class

La clase QGraphicsObject proporciona una clase base para todos los elementos gráficos que requieren señales, ranuras y propiedades. Más...

Cabecera: #include <QGraphicsObject>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Hereda: QObject y QGraphicsItem
Heredado de:

QGraphicsSvgItem, QGraphicsTextItem, y QGraphicsWidget

Propiedades

Funciones públicas

QGraphicsObject(QGraphicsItem *parent = nullptr)
virtual ~QGraphicsObject()
void grabGesture(Qt::GestureType gesture, Qt::GestureFlags flags = Qt::GestureFlags())
void ungrabGesture(Qt::GestureType gesture)

Señales

void enabledChanged()
void opacityChanged()
void parentChanged()
void rotationChanged()
void scaleChanged()
void visibleChanged()
void xChanged()
void yChanged()
void zChanged()

Funciones protegidas reimplementadas

virtual bool event(QEvent *ev) override

Ranuras protegidas

Descripción detallada

Esta clase extiende QGraphicsItem con los mecanismos de señales/ranuras y propiedades de QObject. Asigna muchos de los setters y getters básicos de QGraphicsItem a propiedades y añade señales de notificación para muchas de ellas.

Padres e hijos

Cada objeto gráfico puede construirse con un elemento padre. Esto asegura que el elemento será destruido cuando su elemento padre sea destruido. Aunque QGraphicsObject hereda tanto de QObject como de QGraphicsItem, debes utilizar las funciones proporcionadas por QGraphicsItem, no por QObject, para gestionar las relaciones entre elementos padres e hijos.

Las relaciones entre elementos pueden explorarse utilizando las funciones parentItem() y childItems(). En la jerarquía de elementos de una escena, las funciones parentObject() y parentWidget() equivalen a las funciones QWidget::parent() y QWidget::parentWidget() para las subclases QWidget.

Véase también QGraphicsWidget.

Documentación de propiedades

effect : QGraphicsEffect*

Esta propiedad contiene el efecto asociado a este elemento

Véase también QGraphicsItem::setGraphicsEffect() y QGraphicsItem::graphicsEffect().

enabled : bool

Esta propiedad indica si el elemento está habilitado o no.

Esta propiedad se declara en QGraphicsItem.

Por defecto, esta propiedad es true.

Señal de notificador:

Véase también QGraphicsItem::isEnabled() y QGraphicsItem::setEnabled().

opacity : qreal

Esta propiedad contiene la opacidad del elemento

Notificador:

Véase también QGraphicsItem::setOpacity() y QGraphicsItem::opacity().

parent : QGraphicsObject*

Esta propiedad contiene el padre del elemento

Nota: El padre del elemento se establece independientemente del objeto padre devuelto por QObject::parent().

Señal de notificación:

void parentChanged()

Véase también QGraphicsItem::setParentItem() y QGraphicsItem::parentObject().

pos : QPointF

Esta propiedad contiene la posición del elemento

Describe la posición del elemento.

Véase también QGraphicsItem::setPos() y QGraphicsItem::pos().

rotation : qreal

Esta propiedad contiene la rotación del elemento en grados.

Especifica cuántos grados girar el elemento alrededor de su transformOrigin. La rotación por defecto es de 0 grados (es decir, no se rota en absoluto).

Señal de notificación:

scale : qreal

Esta propiedad contiene la escala del elemento.

Una escala menor que 1 significa que el elemento se mostrará más pequeño de lo normal, y una escala mayor que 1 significa que el elemento se mostrará más grande de lo normal. Una escala negativa significa que el elemento se reflejará.

Por defecto, los elementos se muestran a escala 1 (es decir, a su tamaño normal).

La escala se calcula a partir del transformOrigin del elemento.

Señal de notificación:

void scaleChanged()

transformOriginPoint : QPointF

Esta propiedad contiene el origen de la transformación

Esta propiedad establece un punto específico en el sistema de coordenadas del elemento como origen para la escala y la rotación.

Véase también scale, rotation, y QGraphicsItem::transformOriginPoint().

visible : bool

Esta propiedad indica si el elemento es visible o no.

Esta propiedad se declara en QGraphicsItem.

Por defecto, esta propiedad es true.

Señal de notificador:

Véase también QGraphicsItem::isVisible() y QGraphicsItem::setVisible().

x : qreal

Esta propiedad contiene la posición x del elemento

Describe la posición x del elemento.

Señal del notificador:

void xChanged()

Véase también QGraphicsItem::setX() y setPos().

y : qreal

Esta propiedad contiene la posición y del elemento

Describe la posición y del elemento.

Señal de notificación:

void yChanged()

Véase también QGraphicsItem::setY() y setPos().

z : qreal

Esta propiedad contiene el valor z del elemento

Describe el valor z del elemento.

Señal notificadora:

void zChanged()

Véase también QGraphicsItem::setZValue() y zValue().

Documentación de las funciones miembro

[explicit] QGraphicsObject::QGraphicsObject(QGraphicsItem *parent = nullptr)

Construye un QGraphicsObject con parent.

[virtual noexcept] QGraphicsObject::~QGraphicsObject()

Destructor.

[signal] void QGraphicsObject::enabledChanged()

Esta señal se emite cada vez que el elemento se activa o desactiva.

Nota: Señal notificadora para la propiedad enabled.

Véase también isEnabled().

[override virtual protected] bool QGraphicsObject::event(QEvent *ev)

Reimplementa: QObject::event(QEvent *e).

void QGraphicsObject::grabGesture(Qt::GestureType gesture, Qt::GestureFlags flags = Qt::GestureFlags())

Suscribe el objeto gráfico al gesture dado con flags específico.

Véase también ungrabGesture() y QGestureEvent.

[signal] void QGraphicsObject::opacityChanged()

Esta señal se emite cada vez que cambia la opacidad del elemento

Nota: Señal notificadora para la propiedad opacity.

Véase también QGraphicsItem::opacity().

[signal] void QGraphicsObject::parentChanged()

Esta señal se emite cada vez que cambia el padre del elemento

Nota: Señal notificadora para la propiedad parent.

[signal] void QGraphicsObject::rotationChanged()

Esta señal se emite cada vez que cambia la rotación del elemento.

Nota: Señal notificadora para la propiedad rotation.

[signal] void QGraphicsObject::scaleChanged()

Esta señal se emite cuando cambia la escala del elemento.

Nota: Señal notificadora para la propiedad scale.

void QGraphicsObject::ungrabGesture(Qt::GestureType gesture)

Da de baja el objeto gráfico de la dirección gesture.

Véase también grabGesture() y QGestureEvent.

[protected slot] void QGraphicsObject::updateMicroFocus()

Actualiza el microenfoque del elemento. Se trata de una ranura por comodidad.

Véase también QInputMethod.

[signal] void QGraphicsObject::visibleChanged()

Esta señal se emite cada vez que cambia la visibilidad del elemento

Nota: Señal notificadora para la propiedad visible.

Véase también visible.

[signal] void QGraphicsObject::xChanged()

Esta señal se emite cada vez que cambia la posición x del elemento

Nota: Señal notificadora para la propiedad x.

Véase también pos().

[signal] void QGraphicsObject::yChanged()

Esta señal se emite cada vez que cambia la posición y del elemento.

Nota: Señal notificadora para la propiedad y.

Véase también pos().

[signal] void QGraphicsObject::zChanged()

Esta señal se emite cada vez que cambia el valor z del elemento.

Nota: Señal notificadora para la propiedad z.

Véase también pos().

© 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.