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: |
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
| void | updateMicroFocus() |
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:
| void | enabledChanged() |
Véase también QGraphicsItem::isEnabled() y QGraphicsItem::setEnabled().
opacity : qreal
Esta propiedad indica la opacidad del elemento
Señal del notificador:
| void | opacityChanged() |
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:
| void | rotationChanged() |
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:
| void | visibleChanged() |
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.