summaryrefslogtreecommitdiffstats
path: root/doc/man/man3/tqobjectcleanuphandler.3qt
diff options
context:
space:
mode:
authorTimothy Pearson <kb9vqf@pearsoncomputing.net>2013-11-06 16:23:17 -0600
committerTimothy Pearson <kb9vqf@pearsoncomputing.net>2013-11-06 16:23:17 -0600
commite193e0140419d117a52e3756ddd9d2bdf3ab7a4a (patch)
tree2581a958653985ed91ff63ff702ad47a253553b3 /doc/man/man3/tqobjectcleanuphandler.3qt
parentab9c0372a33806de1210b9b6f3bc7544895ad4fb (diff)
downloadtqt3-e193e0140419d117a52e3756ddd9d2bdf3ab7a4a.tar.gz
tqt3-e193e0140419d117a52e3756ddd9d2bdf3ab7a4a.zip
Automated update from Qt3
Diffstat (limited to 'doc/man/man3/tqobjectcleanuphandler.3qt')
-rw-r--r--doc/man/man3/tqobjectcleanuphandler.3qt152
1 files changed, 152 insertions, 0 deletions
diff --git a/doc/man/man3/tqobjectcleanuphandler.3qt b/doc/man/man3/tqobjectcleanuphandler.3qt
new file mode 100644
index 000000000..7282b8256
--- /dev/null
+++ b/doc/man/man3/tqobjectcleanuphandler.3qt
@@ -0,0 +1,152 @@
+'\" t
+.TH QObjectCleanupHandler 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*-
+.\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the
+.\" license file included in the distribution for a complete license
+.\" statement.
+.\"
+.ad l
+.nh
+.SH NAME
+QObjectCleanupHandler \- Watches the lifetime of multiple QObjects
+.SH SYNOPSIS
+\fC#include <ntqobjectcleanuphandler.h>\fR
+.PP
+Inherits QObject.
+.PP
+.SS "Public Members"
+.in +1c
+.ti -1c
+.BI "\fBQObjectCleanupHandler\fR ()"
+.br
+.ti -1c
+.BI "\fB~QObjectCleanupHandler\fR ()"
+.br
+.ti -1c
+.BI "QObject * \fBadd\fR ( QObject * object )"
+.br
+.ti -1c
+.BI "void \fBremove\fR ( QObject * object )"
+.br
+.ti -1c
+.BI "bool \fBisEmpty\fR () const"
+.br
+.ti -1c
+.BI "void \fBclear\fR ()"
+.br
+.in -1c
+.SH DESCRIPTION
+The QObjectCleanupHandler class watches the lifetime of multiple QObjects.
+.PP
+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.
+.PP
+Example:
+.PP
+.nf
+.br
+ class FactoryComponent : public FactoryInterface, public QLibraryInterface
+.br
+ {
+.br
+ public:
+.br
+ ...
+.br
+.br
+ QObject *createObject();
+.br
+.br
+ bool init();
+.br
+ void cleanup();
+.br
+ bool canUnload() const;
+.br
+.br
+ private:
+.br
+ QObjectCleanupHandler objects;
+.br
+ };
+.br
+.br
+ // allocate a new object, and add it to the cleanup handler
+.br
+ QObject *FactoryComponent::createObject()
+.br
+ {
+.br
+ return objects.add( new QObject() );
+.br
+ }
+.br
+.br
+ // QLibraryInterface implementation
+.br
+ bool FactoryComponent::init()
+.br
+ {
+.br
+ return TRUE;
+.br
+ }
+.br
+.br
+ void FactoryComponent::cleanup()
+.br
+ {
+.br
+ }
+.br
+.br
+ // it is only safe to unload the library when all QObject's have been destroyed
+.br
+ bool FactoryComponent::canUnload() const
+.br
+ {
+.br
+ return objects.isEmpty();
+.br
+ }
+.br
+.fi
+.PP
+See also Object Model.
+.SH MEMBER FUNCTION DOCUMENTATION
+.SH "QObjectCleanupHandler::QObjectCleanupHandler ()"
+Constructs an empty QObjectCleanupHandler.
+.SH "QObjectCleanupHandler::~QObjectCleanupHandler ()"
+Destroys the cleanup handler. All objects in this cleanup handler will be deleted.
+.SH "QObject * QObjectCleanupHandler::add ( QObject * object )"
+Adds \fIobject\fR to this cleanup handler and returns the pointer to the object.
+.SH "void QObjectCleanupHandler::clear ()"
+Deletes all objects in this cleanup handler. The cleanup handler becomes empty.
+.SH "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.
+.SH "void QObjectCleanupHandler::remove ( QObject * object )"
+Removes the \fIobject\fR from this cleanup handler. The object will
+not be destroyed.
+
+.SH "SEE ALSO"
+.BR http://doc.trolltech.com/ntqobjectcleanuphandler.html
+.BR http://www.trolltech.com/faq/tech.html
+.SH COPYRIGHT
+Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the
+license file included in the distribution for a complete license
+statement.
+.SH AUTHOR
+Generated automatically from the source code.
+.SH BUGS
+If you find a bug in Qt, please report it as described in
+.BR http://doc.trolltech.com/bughowto.html .
+Good bug reports help us to help you. Thank you.
+.P
+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.
+.P
+If you find errors in this manual page, please report them to
+.BR qt-bugs@trolltech.com .
+Please include the name of the manual page (tqobjectcleanuphandler.3qt) and the Qt
+version (3.3.8).