En esta página

QObjectCleanupHandler Class

La clase QObjectCleanupHandler supervisa el ciclo de vida de varios QObjects. Más información...

Encabezado: #include <QObjectCleanupHandler>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Heredan: QObject

Funciones públicas

QObjectCleanupHandler()
virtual ~QObjectCleanupHandler()
QObject *add(QObject *object)
void clear()
bool isEmpty() const
void remove(QObject *object)

Descripción detallada

Un QObjectCleanupHandler resulta útil siempre que se necesite saber cuándo se han eliminado varios objetos de tipo « QObject» que pertenecen a otra entidad. Esto es importante, por ejemplo, al hacer referencia a memoria en una aplicación que ha sido asignada en una biblioteca compartida.

Para realizar un seguimiento de algunos objetos ` QObject`, crea un `QObjectCleanupHandler` y añade los objetos que te interesen mediante ` add()`. Si ya no te interesa realizar el seguimiento de un objeto concreto, utiliza ` remove()` para eliminarlo del gestor de limpieza. Si un objeto del que realiza seguimiento el gestor de limpieza es eliminado por otra entidad, se eliminará automáticamente del gestor de limpieza. Puedes eliminar todos los objetos del gestor de limpieza con ` clear()` o destruyendo el propio gestor. ` isEmpty()` devuelve ` true ` si el `QObjectCleanupHandler` no tiene ningún objeto del que realizar un seguimiento.

Véase también QPointer.

Documentación de las funciones miembro

QObjectCleanupHandler::QObjectCleanupHandler()

Crea un objeto `QObjectCleanupHandler` vacío.

[virtual noexcept] QObjectCleanupHandler::~QObjectCleanupHandler()

Elimina el controlador de limpieza. Se eliminarán todos los objetos de este controlador de limpieza.

Véase también clear().

QObject *QObjectCleanupHandler::add(QObject *object)

Añade ` object ` a este controlador de limpieza y devuelve el puntero al objeto.

Véase también remove().

void QObjectCleanupHandler::clear()

Elimina todos los objetos de este controlador de limpieza. El controlador de limpieza queda vacío.

Véase también isEmpty().

bool QObjectCleanupHandler::isEmpty() const

Devuelve « true » si este controlador de limpieza está vacío o si se han destruido todos los objetos de dicho controlador; en caso contrario, devuelve «false».

Véase también add(), remove() y clear().

void QObjectCleanupHandler::remove(QObject *object)

Elimina el objeto ` object ` de este controlador de limpieza. El objeto no se destruirá.

Véase también add().

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