QObjectCleanupHandler Class
La classe `QObjectCleanupHandler` surveille le cycle de vie de plusieurs objets `QObject`. En savoir plus...
| En-tête : | #include <QObjectCleanupHandler> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake : | QT += core |
| Hérite de : | QObject |
Fonctions publiques
| QObjectCleanupHandler() | |
| virtual | ~QObjectCleanupHandler() |
| QObject * | add(QObject *object) |
| void | clear() |
| bool | isEmpty() const |
| void | remove(QObject *object) |
Description détaillée
Un QObjectCleanupHandler est utile chaque fois que vous avez besoin de savoir quand un certain nombre d'QObjects appartenant à quelqu'un d'autre ont été supprimés. Cela est important, par exemple, lorsque vous référencez de la mémoire dans une application qui a été allouée dans une bibliothèque partagée.
Pour suivre certains objets ` QObject`, créez un `QObjectCleanupHandler` et ajoutez-y les objets qui vous intéressent à l'aide de la fonction ` add()`. Si vous ne souhaitez plus suivre un objet particulier, utilisez la fonction ` remove()` pour le retirer du gestionnaire de nettoyage. Si un objet suivi par le gestionnaire de nettoyage est supprimé par quelqu'un d'autre, il sera automatiquement retiré du gestionnaire de nettoyage. Vous pouvez supprimer tous les objets du gestionnaire de nettoyage à l’aide de ` clear()` ou en détruisant le gestionnaire de nettoyage. La fonction ` isEmpty()` renvoie ` true ` si le `QObjectCleanupHandler` ne contient aucun objet à suivre.
Voir également QPointer.
Documentation des fonctions membres
QObjectCleanupHandler::QObjectCleanupHandler()
Crée un objet `QObjectCleanupHandler` vide.
[virtual noexcept] QObjectCleanupHandler::~QObjectCleanupHandler()
Supprime le gestionnaire de nettoyage. Tous les objets contenus dans ce gestionnaire de nettoyage seront supprimés.
Voir également clear().
QObject *QObjectCleanupHandler::add(QObject *object)
Ajoute ` object ` à ce gestionnaire de nettoyage et renvoie le pointeur vers l'objet.
Voir également remove().
void QObjectCleanupHandler::clear()
Supprime tous les objets contenus dans ce gestionnaire de nettoyage. Le gestionnaire de nettoyage se retrouve alors vide.
Voir également isEmpty().
bool QObjectCleanupHandler::isEmpty() const
Renvoie true si ce gestionnaire de nettoyage est vide ou si tous les objets qu'il contient ont été détruits ; sinon, renvoie false.
Voir également add(), remove() et clear().
void QObjectCleanupHandler::remove(QObject *object)
Supprime l'object de ce gestionnaire de nettoyage. L'objet ne sera pas détruit.
Voir aussi 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.
