You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tqt3/doc/man/man3/tqcustomevent.3qt

131 lines
4.3 KiB

'\" t
.TH TQCustomEvent 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
TQCustomEvent \- Support for custom events
.SH SYNOPSIS
\fC#include <tqevent.h>\fR
.PP
Inherits TQEvent.
.PP
.SS "Public Members"
.in +1c
.ti -1c
.BI "\fBTQCustomEvent\fR ( int type )"
.br
.ti -1c
.BI "\fBTQCustomEvent\fR ( Type type, void * data )"
.br
.ti -1c
.BI "void * \fBdata\fR () const"
.br
.ti -1c
.BI "void \fBsetData\fR ( void * data )"
.br
.in -1c
.SH DESCRIPTION
The TQCustomEvent class provides support for custom events.
.PP
TQCustomEvent is a generic event class for user-defined events. User defined events can be sent to widgets or other TQObject instances using TQApplication::postEvent() or TQApplication::sendEvent(). Subclasses of TQObject can easily receive custom events by implementing the TQObject::customEvent() event handler function.
.PP
TQCustomEvent objects should be created with a type ID that uniquely identifies the event type. To avoid clashes with the Qt-defined events types, the value should be at least as large as the value of the "User" entry in the TQEvent::Type enum.
.PP
TQCustomEvent contains a generic void* data member that may be used for transferring event-specific data to the receiver. Note that since events are normally delivered asynchronously, the data pointer, if used, must remain valid until the event has been received and processed.
.PP
TQCustomEvent can be used as-is for simple user-defined event types, but normally you will want to make a subclass of it for your event types. In a subclass, you can add data members that are suitable for your event type.
.PP
Example:
.PP
.nf
.br
class ColorChangeEvent : public TQCustomEvent
.br
{
.br
public:
.br
ColorChangeEvent( TQColor color )
.br
: TQCustomEvent( 65432 ), c( color ) {}
.br
TQColor color() const { return c; }
.br
private:
.br
TQColor c;
.br
};
.br
.br
// To send an event of this custom event type:
.br
.br
ColorChangeEvent* ce = new ColorChangeEvent( blue );
.br
TQApplication::postEvent( receiver, ce ); // TQt will delete it when done
.br
.br
// To receive an event of this custom event type:
.br
.br
void MyWidget::customEvent( TQCustomEvent * e )
.br
{
.br
if ( e->type() == 65432 ) { // It must be a ColorChangeEvent
.br
ColorChangeEvent* ce = (ColorChangeEvent*)e;
.br
newColor = ce->color();
.br
}
.br
}
.br
.fi
.PP
See also TQWidget::customEvent(), TQApplication::notify(), and Event Classes.
.SH MEMBER FUNCTION DOCUMENTATION
.SH "TQCustomEvent::TQCustomEvent ( int type )"
Constructs a custom event object with event type \fItype\fR. The value of \fItype\fR must be at least as large as TQEvent::User. The data pointer is set to 0.
.SH "TQCustomEvent::TQCustomEvent ( Type type, void * data )"
Constructs a custom event object with the event type \fItype\fR and a pointer to \fIdata\fR. (Note that any int value may safely be cast to TQEvent::Type).
.SH "void * TQCustomEvent::data () const"
Returns a pointer to the generic event data.
.PP
See also setData().
.SH "void TQCustomEvent::setData ( void * data )"
Sets the generic data pointer to \fIdata\fR.
.PP
See also data().
.SH "SEE ALSO"
.BR http://doc.trolltech.com/tqcustomevent.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 TQt documentation is provided in HTML format; it is
located at $TQTDIR/doc/html and can be read using TQt 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 (tqcustomevent.3qt) and the Qt
version (3.3.8).