diff options
Diffstat (limited to 'doc/html/qcustomevent.html')
-rw-r--r-- | doc/html/qcustomevent.html | 136 |
1 files changed, 136 insertions, 0 deletions
diff --git a/doc/html/qcustomevent.html b/doc/html/qcustomevent.html new file mode 100644 index 000000000..3c727fa22 --- /dev/null +++ b/doc/html/qcustomevent.html @@ -0,0 +1,136 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/kernel/qevent.cpp:2197 --> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> +<title>TQCustomEvent Class</title> +<style type="text/css"><!-- +fn { margin-left: 1cm; text-indent: -1cm; } +a:link { color: #004faf; text-decoration: none } +a:visited { color: #672967; text-decoration: none } +body { background: #ffffff; color: black; } +--></style> +</head> +<body> + +<table border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr bgcolor="#E5E5E5"> +<td valign=center> + <a href="index.html"> +<font color="#004faf">Home</font></a> + | <a href="classes.html"> +<font color="#004faf">All Classes</font></a> + | <a href="mainclasses.html"> +<font color="#004faf">Main Classes</font></a> + | <a href="annotated.html"> +<font color="#004faf">Annotated</font></a> + | <a href="groups.html"> +<font color="#004faf">Grouped Classes</font></a> + | <a href="functions.html"> +<font color="#004faf">Functions</font></a> +</td> +<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQCustomEvent Class Reference</h1> + +<p>The TQCustomEvent class provides support for custom events. +<a href="#details">More...</a> +<p><tt>#include <<a href="qevent-h.html">qevent.h</a>></tt> +<p>Inherits <a href="qevent.html">TQEvent</a>. +<p><a href="qcustomevent-members.html">List of all member functions.</a> +<h2>Public Members</h2> +<ul> +<li class=fn><a href="#TQCustomEvent"><b>TQCustomEvent</b></a> ( int type )</li> +<li class=fn><a href="#TQCustomEvent-2"><b>TQCustomEvent</b></a> ( Type type, void * data )</li> +<li class=fn>void * <a href="#data"><b>data</b></a> () const</li> +<li class=fn>void <a href="#setData"><b>setData</b></a> ( void * data )</li> +</ul> +<hr><a name="details"></a><h2>Detailed Description</h2> + + +The TQCustomEvent class provides support for custom events. +<p> +<p> TQCustomEvent is a generic event class for user-defined events. +User defined events can be sent to widgets or other <a href="qobject.html">TQObject</a> +instances using <a href="qapplication.html#postEvent">TQApplication::postEvent</a>() or +<a href="qapplication.html#sendEvent">TQApplication::sendEvent</a>(). Subclasses of TQObject can easily +receive custom events by implementing the <a href="qobject.html#customEvent">TQObject::customEvent</a>() +event handler function. +<p> TQCustomEvent objects should be created with a type ID that +uniquely identifies the event type. To avoid clashes with the +TQt-defined events types, the value should be at least as large as +the value of the "User" entry in the TQEvent::Type enum. +<p> 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. +<p> 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. +<p> Example: +<pre> + class ColorChangeEvent : public TQCustomEvent + { + public: + ColorChangeEvent( <a href="qcolor.html">TQColor</a> color ) + : TQCustomEvent( 65432 ), c( color ) {} + <a href="qcolor.html">TQColor</a> color() const { return c; } + private: + <a href="qcolor.html">TQColor</a> c; + }; + + // To send an event of this custom event type: + + ColorChangeEvent* ce = new ColorChangeEvent( blue ); + TQApplication::<a href="qapplication.html#postEvent">postEvent</a>( receiver, ce ); // TQt will delete it when done + + // To receive an event of this custom event type: + + void MyWidget::customEvent( TQCustomEvent * e ) + { + if ( e-><a href="qevent.html#type">type</a>() == 65432 ) { // It must be a ColorChangeEvent + ColorChangeEvent* ce = (ColorChangeEvent*)e; + newColor = ce->color(); + } + } + </pre> + +<p> <p>See also <a href="qobject.html#customEvent">TQWidget::customEvent</a>(), <a href="qapplication.html#notify">TQApplication::notify</a>(), and <a href="events.html">Event Classes</a>. + +<hr><h2>Member Function Documentation</h2> +<h3 class=fn><a name="TQCustomEvent"></a>TQCustomEvent::TQCustomEvent ( int type ) +</h3> +Constructs a custom event object with event type <em>type</em>. The +value of <em>type</em> must be at least as large as TQEvent::User. The +data pointer is set to 0. + +<h3 class=fn><a name="TQCustomEvent-2"></a>TQCustomEvent::TQCustomEvent ( <a href="qevent.html#Type-enum">Type</a> type, void * data ) +</h3> + +<p> Constructs a custom event object with the event type <em>type</em> and a +pointer to <em>data</em>. (Note that any int value may safely be cast to +TQEvent::Type). + +<h3 class=fn>void * <a name="data"></a>TQCustomEvent::data () const +</h3> + +<p> Returns a pointer to the generic event data. +<p> <p>See also <a href="#setData">setData</a>(). + +<h3 class=fn>void <a name="setData"></a>TQCustomEvent::setData ( void * data ) +</h3> + +<p> Sets the generic data pointer to <em>data</em>. +<p> <p>See also <a href="#data">data</a>(). + +<!-- eof --> +<hr><p> +This file is part of the <a href="index.html">TQt toolkit</a>. +Copyright © 1995-2007 +<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center> +<table width=100% cellspacing=0 border=0><tr> +<td>Copyright © 2007 +<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a> +<td align=right><div align=right>TQt 3.3.8</div> +</table></div></address></body> +</html> |