QObjectCleanupHandler

Section: Misc. Reference Manual Pages (3qt)
Updated: 2 February 2007
Index Return to Main Contents
 

NAME

QObjectCleanupHandler - Watches the lifetime of multiple QObjects  

SYNOPSIS

#include <qobjectcleanuphandler.h>

Inherits QObject.

 

Public Members


QObjectCleanupHandler ()

~QObjectCleanupHandler ()

QObject * add ( QObject * object )

void remove ( QObject * object )

bool isEmpty () const

void clear ()
 

DESCRIPTION

The QObjectCleanupHandler class watches the lifetime of multiple QObjects.

A QObjectCleanupHandler is useful whenever you need to know when a number of QObjects that are owned by someone else have been deleted. This is important, for example, when referencing memory in an application that has been allocated in a shared library.

Example:


class FactoryComponent : public FactoryInterface, public QLibraryInterface
{
public:
...

QObject *createObject();

bool init();
void cleanup();
bool canUnload() const;

private:
QObjectCleanupHandler objects;
};

// allocate a new object, and add it to the cleanup handler
QObject *FactoryComponent::createObject()
{
return objects.add( new QObject() );
}

// QLibraryInterface implementation
bool FactoryComponent::init()
{
return TRUE;
}

void FactoryComponent::cleanup()
{
}

// it is only safe to unload the library when all QObject's have been destroyed
bool FactoryComponent::canUnload() const
{
return objects.isEmpty();
}

See also Object Model.  

MEMBER FUNCTION DOCUMENTATION

 

QObjectCleanupHandler::QObjectCleanupHandler ()

Constructs an empty QObjectCleanupHandler.  

QObjectCleanupHandler::~QObjectCleanupHandler ()

Destroys the cleanup handler. All objects in this cleanup handler will be deleted.  

QObject * QObjectCleanupHandler::add ( QObject * object )

Adds object to this cleanup handler and returns the pointer to the object.  

void QObjectCleanupHandler::clear ()

Deletes all objects in this cleanup handler. The cleanup handler becomes empty.  

bool QObjectCleanupHandler::isEmpty () const

Returns TRUE if this cleanup handler is empty or if all objects in this cleanup handler have been destroyed; otherwise return FALSE.  

void QObjectCleanupHandler::remove ( QObject * object )

Removes the object from this cleanup handler. The object will not be destroyed.

 

SEE ALSO

http://doc.trolltech.com/qobjectcleanuphandler.html http://www.trolltech.com/faq/tech.html  

COPYRIGHT

Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the license file included in the distribution for a complete license statement.  

AUTHOR

Generated automatically from the source code.  

BUGS

If you find a bug in Qt, please report it as described in http://doc.trolltech.com/bughowto.html. Good bug reports help us to help you. Thank you. The definitive Qt documentation is provided in HTML format; it is located at $QTDIR/doc/html and can be read using Qt Assistant or with a web browser. This man page is provided as a convenience for those users who prefer man pages, although this format is not officially supported by Trolltech. If you find errors in this manual page, please report them to qt-bugs@trolltech.com. Please include the name of the manual page (qobjectcleanuphandler.3qt) and the Qt version (3.3.8).