qchildevent.3qt - Man Page

Event parameters for child object events

Synopsis

#include <qevent.h>

Inherits QEvent.

Public Members

QChildEvent ( Type type, QObject * child )
QObject * child () const
bool inserted () const
bool removed () const

Description

The QChildEvent class contains event parameters for child object events.

Child events are sent to objects when children are inserted or removed.

A ChildRemoved event is sent immediately, but a ChildInserted event is posted (with QApplication::postEvent()).

Note that if a child is removed immediately after it is inserted, the ChildInserted event may be suppressed, but the ChildRemoved event will always be sent. In this case there will be a ChildRemoved event without a corresponding ChildInserted event.

The handler for these events is QObject::childEvent().

See also Event Classes.

Member Function Documentation

QChildEvent::QChildEvent ( Type type, QObject * child )

Constructs a child event object. The child is the object that is to be removed or inserted.

The type parameter must be either QEvent::ChildInserted or QEvent::ChildRemoved.

QObject * QChildEvent::child () const

Returns the child widget that was inserted or removed.

bool QChildEvent::inserted () const

Returns TRUE if the widget received a new child; otherwise returns FALSE.

bool QChildEvent::removed () const

Returns TRUE if the object lost a child; otherwise returns FALSE.

See Also

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

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 (qchildevent.3qt) and the Qt version (3.3.8).

Referenced By

The man page QChildEvent.3qt(3) is an alias of qchildevent.3qt(3).

2 February 2007 Trolltech AS