En esta página

QGraphicsObject Class

La clase QGraphicsObject sirve de clase base para todos los elementos gráficos que requieren señales, ranuras y propiedades. Más información...

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

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

La clase extiende una « 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 muchos de ellos.

Padres e hijos

Cada objeto gráfico puede crearse con un elemento padre. Esto garantiza que el elemento se destruya cuando se destruya su elemento padre. Aunque `QGraphicsObject` hereda tanto de ` QObject ` como de ` QGraphicsItem`, debes utilizar las funciones proporcionadas por ` QGraphicsItem`, y 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()` son equivalentes a las funciones ` QWidget::parent()` y ` QWidget::parentWidget()` para las subclases de ` 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 se mantiene independientemente de si el elemento está habilitado o no

Esta propiedad se declara en QGraphicsItem.

Por defecto, esta propiedad es true.

Señal del notificador:

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

opacity : qreal

Esta propiedad indica la opacidad del elemento

Señal del notificador:

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

parent : QGraphicsObject*

Esta propiedad contiene el objeto padre del elemento

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

Señal del notificador:

void parentChanged()

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

pos : QPointF

Esta propiedad indica la posición del elemento

Describe la posición del elemento.

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

rotation : qreal

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

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

Señal de notificación:

scale : qreal

Esta propiedad determina la escala del elemento.

Una escala inferior a 1 significa que el elemento se mostrará más pequeño de lo normal, y una escala superior a 1 significa que el elemento se mostrará más grande de lo normal. Una escala negativa significa que el elemento se mostrará invertido.

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

El escalado se realiza a partir del punto de origen de transformación del elemento.

Señal de notificación:

void scaleChanged()

transformOriginPoint : QPointF

Esta propiedad define el origen de la transformación

Esta propiedad establece un punto específico del 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 se mantiene independientemente de si el elemento está visible o no

Esta propiedad se declara en QGraphicsItem.

Por defecto, esta propiedad es « true ».

Señal del 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 de notificación:

void xChanged()

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

y : qreal

Esta propiedad contiene la posición en el eje 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 de notificación:

void zChanged()

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

Documentación de funciones de miembro

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

Crea 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 se desactiva.

Nota: Señalde notificación 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 canal « gesture » indicado con el valor « 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ñalde notificación para la propiedad opacity.

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

[signal] void QGraphicsObject::parentChanged()

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

Nota: Señalde Notifier para la propiedad « parent ».

[signal] void QGraphicsObject::rotationChanged()

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

Nota: Señalde notificación para la propiedad « rotation ».

[signal] void QGraphicsObject::scaleChanged()

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

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

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

Da de baja el objeto gráfico de la lista de suscriptores de « gesture » indicada.

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

[protected slot] void QGraphicsObject::updateMicroFocus()

Actualiza el microenfoque del objeto. Se trata de una ranura de uso práctico.

Véase también QInputMethod.

[signal] void QGraphicsObject::visibleChanged()

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

Nota: Señalde notificación 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ñalde notificación 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ñalde notificación 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ñalde notificación 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.