summaryrefslogtreecommitdiffstats
path: root/doc/html/tqevent.html
blob: a67c9018f2b4fb9114574a6e2c2f37593df529d5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>TQEvent 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&nbsp;Classes</font></a>
 | <a href="mainclasses.html">
<font color="#004faf">Main&nbsp;Classes</font></a>
 | <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
 | <a href="groups.html">
<font color="#004faf">Grouped&nbsp;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>TQEvent Class Reference</h1>

<p>The TQEvent class is the base class of all
event classes. Event objects contain event parameters.
<a href="#details">More...</a>
<p><tt>#include &lt;<a href="tqevent-h.html">tqevent.h</a>&gt;</tt>
<p>Inherits <a href="tqt.html">TQt</a>.
<p>Inherited by <a href="tqtimerevent.html">TQTimerEvent</a>, <a href="tqmouseevent.html">TQMouseEvent</a>, <a href="qwheelevent.html">TQWheelEvent</a>, <a href="tqtabletevent.html">TQTabletEvent</a>, <a href="tqkeyevent.html">TQKeyEvent</a>, <a href="tqfocusevent.html">TQFocusEvent</a>, <a href="tqpaintevent.html">TQPaintEvent</a>, <a href="tqmoveevent.html">TQMoveEvent</a>, <a href="tqresizeevent.html">TQResizeEvent</a>, <a href="tqcloseevent.html">TQCloseEvent</a>, <a href="tqicondragevent.html">TQIconDragEvent</a>, <a href="tqshowevent.html">TQShowEvent</a>, <a href="tqhideevent.html">TQHideEvent</a>, <a href="tqcontextmenuevent.html">TQContextMenuEvent</a>, <a href="tqimevent.html">TQIMEvent</a>, <a href="tqdropevent.html">TQDropEvent</a>, <a href="tqdragleaveevent.html">TQDragLeaveEvent</a>, <a href="tqchildevent.html">TQChildEvent</a>, and <a href="tqcustomevent.html">TQCustomEvent</a>.
<p><a href="tqevent-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
<li class=fn>enum <a href="#Type-enum"><b>Type</b></a> { None = 0, Timer = 1, MouseButtonPress = 2, MouseButtonRelease = 3, MouseButtonDblClick = 4, MouseMove = 5, KeyPress = 6, KeyRelease = 7, FocusIn = 8, FocusOut = 9, Enter = 10, Leave = 11, Paint = 12, Move = 13, Resize = 14, Create = 15, Destroy = 16, Show = 17, Hide = 18, Close = 19, Quit = 20, Reparent = 21, ShowMinimized = 22, ShowNormal = 23, WindowActivate = 24, WindowDeactivate = 25, ShowToParent = 26, HideToParent = 27, ShowMaximized = 28, ShowFullScreen = 29, Accel = 30, Wheel = 31, AccelAvailable = 32, CaptionChange = 33, IconChange = 34, ParentFontChange = 35, ApplicationFontChange = 36, ParentPaletteChange = 37, ApplicationPaletteChange = 38, PaletteChange = 39, Clipboard = 40, Speech = 42, SockAct = 50, AccelOverride = 51, DeferredDelete = 52, DragEnter = 60, DragMove = 61, DragLeave = 62, Drop = 63, DragResponse = 64, ChildInserted = 70, ChildRemoved = 71, LayoutHint = 72, ShowWindowRequest = 73, WindowBlocked = 74, WindowUnblocked = 75, ActivateControl = 80, DeactivateControl = 81, ContextMenu = 82, IMStart = 83, IMCompose = 84, IMEnd = 85, Accessibility = 86, TabletMove = 87, LocaleChange = 88, LanguageChange = 89, LayoutDirectionChange = 90, Style = 91, TabletPress = 92, TabletRelease = 93, OkRequest = 94, HelpRequest = 95, WindowStateChange = 96, IconDrag = 97, User = 1000, MaxUser = 65535 }</li>
<li class=fn><a href="#TQEvent"><b>TQEvent</b></a> ( Type&nbsp;type )</li>
<li class=fn>virtual <a href="#~TQEvent"><b>~TQEvent</b></a> ()</li>
<li class=fn>Type <a href="#type"><b>type</b></a> () const</li>
<li class=fn>bool <a href="#spontaneous"><b>spontaneous</b></a> () const</li>
</ul>
<hr><a name="details"></a><h2>Detailed Description</h2>


The TQEvent class is the base class of all
event classes. Event objects contain event parameters.
<p> 

<p> TQt's main event loop (<a href="ntqapplication.html#exec">TQApplication::exec</a>()) fetches native window
system events from the event queue, translates them into TQEvents
and sends the translated events to TQObjects.
<p> In general, events come from the underlying window system
(<a href="#spontaneous">spontaneous</a>() returns TRUE) but it is also possible to manually
send events using <a href="ntqapplication.html#sendEvent">TQApplication::sendEvent</a>() and
<a href="ntqapplication.html#postEvent">TQApplication::postEvent</a>() (spontaneous() returns FALSE).
<p> TQObjects receive events by having their <a href="tqobject.html#event">TQObject::event</a>() function
called. The function can be reimplemented in subclasses to
customize event handling and add additional event types;
<a href="tqwidget.html#event">TQWidget::event</a>() is a notable example. By default, events are
dispatched to event handlers like <a href="tqobject.html#timerEvent">TQObject::timerEvent</a>() and
<a href="tqwidget.html#mouseMoveEvent">TQWidget::mouseMoveEvent</a>(). <a href="tqobject.html#installEventFilter">TQObject::installEventFilter</a>() allows an
object to intercept events destined for another object.
<p> The basic TQEvent contains only an event type parameter.
Subclasses of TQEvent contain additional parameters that describe
the particular event.
<p> <p>See also <a href="tqobject.html#event">TQObject::event</a>(), <a href="tqobject.html#installEventFilter">TQObject::installEventFilter</a>(), <a href="tqwidget.html#event">TQWidget::event</a>(), <a href="ntqapplication.html#sendEvent">TQApplication::sendEvent</a>(), <a href="ntqapplication.html#postEvent">TQApplication::postEvent</a>(), <a href="ntqapplication.html#processEvents">TQApplication::processEvents</a>(), <a href="environment.html">Environment Classes</a>, and <a href="events.html">Event Classes</a>.

<hr><h2>Member Type Documentation</h2>
<h3 class=fn><a name="Type-enum"></a>TQEvent::Type</h3>

<p> This enum type defines the valid event types in TQt. The event
types and the specialized classes for each type are these:
<ul>
<li><tt>TQEvent::None</tt> - Not an event.
<li><tt>TQEvent::Accessibility</tt> - Accessibility information is requested
<li><tt>TQEvent::Timer</tt> - Regular timer events, <a href="tqtimerevent.html">TQTimerEvent</a>.
<li><tt>TQEvent::MouseButtonPress</tt> - Mouse press, <a href="tqmouseevent.html">TQMouseEvent</a>.
<li><tt>TQEvent::MouseButtonRelease</tt> - Mouse release, <a href="tqmouseevent.html">TQMouseEvent</a>.
<li><tt>TQEvent::MouseButtonDblClick</tt> - Mouse press again, <a href="tqmouseevent.html">TQMouseEvent</a>.
<li><tt>TQEvent::MouseMove</tt> - Mouse move, <a href="tqmouseevent.html">TQMouseEvent</a>.
<li><tt>TQEvent::KeyPress</tt> - Key press (including Shift, for example), <a href="tqkeyevent.html">TQKeyEvent</a>.
<li><tt>TQEvent::KeyRelease</tt> - Key release, <a href="tqkeyevent.html">TQKeyEvent</a>.
<li><tt>TQEvent::IMStart</tt> - The start of input method composition, <a href="tqimevent.html">TQIMEvent</a>.
<li><tt>TQEvent::IMCompose</tt> - Input method composition is taking place, <a href="tqimevent.html">TQIMEvent</a>.
<li><tt>TQEvent::IMEnd</tt> - The end of input method composition, <a href="tqimevent.html">TQIMEvent</a>.
<li><tt>TQEvent::FocusIn</tt> - Widget gains <a href="focus.html#keyboard-focus">keyboard focus</a>, <a href="tqfocusevent.html">TQFocusEvent</a>.
<li><tt>TQEvent::FocusOut</tt> - Widget loses keyboard focus, <a href="tqfocusevent.html">TQFocusEvent</a>.
<li><tt>TQEvent::Enter</tt> - Mouse enters widget's boundaries.
<li><tt>TQEvent::Leave</tt> - Mouse leaves widget's boundaries.
<li><tt>TQEvent::Paint</tt> - Screen update necessary, <a href="tqpaintevent.html">TQPaintEvent</a>.
<li><tt>TQEvent::Move</tt> - Widget's position changed, <a href="tqmoveevent.html">TQMoveEvent</a>.
<li><tt>TQEvent::Resize</tt> - Widget's size changed, <a href="tqresizeevent.html">TQResizeEvent</a>.
<li><tt>TQEvent::Show</tt> - Widget was shown on screen, <a href="tqshowevent.html">TQShowEvent</a>.
<li><tt>TQEvent::Hide</tt> - Widget was hidden, <a href="tqhideevent.html">TQHideEvent</a>.
<li><tt>TQEvent::ShowToParent</tt> - A child widget has been shown.
<li><tt>TQEvent::HideToParent</tt> - A child widget has been hidden.
<li><tt>TQEvent::Close</tt> - Widget was closed (permanently), <a href="tqcloseevent.html">TQCloseEvent</a>.
<li><tt>TQEvent::ShowNormal</tt> - Widget should be shown normally (obsolete).
<li><tt>TQEvent::ShowMaximized</tt> - Widget should be shown maximized (obsolete).
<li><tt>TQEvent::ShowMinimized</tt> - Widget should be shown minimized (obsolete).
<li><tt>TQEvent::ShowFullScreen</tt> - Widget should be shown full-screen (obsolete).
<li><tt>TQEvent::ShowWindowRequest</tt> - Widget's window should be shown (obsolete).
<li><tt>TQEvent::DeferredDelete</tt> - The object will be deleted after it has
cleaned up.
<li><tt>TQEvent::Accel</tt> - Key press in child for shortcut key handling, <a href="tqkeyevent.html">TQKeyEvent</a>.
<li><tt>TQEvent::Wheel</tt> - Mouse wheel rolled, <a href="qwheelevent.html">TQWheelEvent</a>.
<li><tt>TQEvent::ContextMenu</tt> - Context popup menu, <a href="tqcontextmenuevent.html">TQContextMenuEvent</a>
<li><tt>TQEvent::AccelOverride</tt> - Key press in child, for overriding shortcut key handling, <a href="tqkeyevent.html">TQKeyEvent</a>.
<li><tt>TQEvent::AccelAvailable</tt> - internal.
<li><tt>TQEvent::WindowActivate</tt> - Window was activated.
<li><tt>TQEvent::WindowDeactivate</tt> - Window was deactivated.
<li><tt>TQEvent::CaptionChange</tt> - Widget's caption changed.
<li><tt>TQEvent::IconChange</tt> - Widget's icon changed.
<li><tt>TQEvent::ParentFontChange</tt> - Font of the parent widget changed.
<li><tt>TQEvent::ApplicationFontChange</tt> - Default application font changed.
<li><tt>TQEvent::PaletteChange</tt> - Palette of the widget changed.
<li><tt>TQEvent::ParentPaletteChange</tt> - Palette of the parent widget changed.
<li><tt>TQEvent::ApplicationPaletteChange</tt> - Default application palette changed.
<li><tt>TQEvent::Clipboard</tt> - Clipboard contents have changed.
<li><tt>TQEvent::SockAct</tt> - Socket activated, used to implement <a href="tqsocketnotifier.html">TQSocketNotifier</a>.
<li><tt>TQEvent::DragEnter</tt> - A drag-and-drop enters widget, <a href="tqdragenterevent.html">TQDragEnterEvent</a>.
<li><tt>TQEvent::DragMove</tt> - A drag-and-drop is in progress, <a href="tqdragmoveevent.html">TQDragMoveEvent</a>.
<li><tt>TQEvent::DragLeave</tt> - A drag-and-drop leaves widget, <a href="tqdragleaveevent.html">TQDragLeaveEvent</a>.
<li><tt>TQEvent::Drop</tt> - A drag-and-drop is completed, <a href="tqdropevent.html">TQDropEvent</a>.
<li><tt>TQEvent::DragResponse</tt> - Internal event used by TQt on some platforms.
<li><tt>TQEvent::ChildInserted</tt> - Object gets a child, <a href="tqchildevent.html">TQChildEvent</a>.
<li><tt>TQEvent::ChildRemoved</tt> - Object loses a child, <a href="tqchildevent.html">TQChildEvent</a>.
<li><tt>TQEvent::LayoutHint</tt> - Widget child has changed layout properties.
<li><tt>TQEvent::ActivateControl</tt> - Internal event used by TQt on some platforms.
<li><tt>TQEvent::DeactivateControl</tt> - Internal event used by TQt on some platforms.
<li><tt>TQEvent::LanguageChange</tt> - The application translation changed, <a href="tqtranslator.html">TQTranslator</a>
<li><tt>TQEvent::LayoutDirectionChange</tt> - The direction of layouts changed
<li><tt>TQEvent::LocaleChange</tt> - The system locale changed
<li><tt>TQEvent::Quit</tt> - Reserved.
<li><tt>TQEvent::Create</tt> - Reserved.
<li><tt>TQEvent::Destroy</tt> - Reserved.
<li><tt>TQEvent::Reparent</tt> - Reserved.
<li><tt>TQEvent::Speech</tt> - Reserved for speech input.
<li><tt>TQEvent::TabletMove</tt> - A Wacom Tablet Move Event.
<li><tt>TQEvent::Style</tt> - Internal use only
<li><tt>TQEvent::TabletPress</tt> - A Wacom Tablet Press Event
<li><tt>TQEvent::TabletRelease</tt> - A Wacom Tablet Release Event
<li><tt>TQEvent::OkRequest</tt> - Internal event used by TQt on some platforms.
<li><tt>TQEvent::HelpRequest</tt> - Internal event used by TQt on some platforms.
<li><tt>TQEvent::IconDrag</tt> - Internal event used by TQt on some platforms when proxy icon is dragged.
<li><tt>TQEvent::WindowStateChange</tt> - The window's state, i.e. minimized,
maximized or full-screen, has changed. See <a href="tqwidget.html#windowState">TQWidget::windowState</a>().
<li><tt>TQEvent::WindowBlocked</tt> - The window is modally blocked
<li><tt>TQEvent::WindowUnblocked</tt> - The window leaves modal blocking
<li><tt>TQEvent::User</tt> - User defined event.
<li><tt>TQEvent::MaxUser</tt> - Last user event id.
</ul><p> User events should have values between User and MaxUser inclusive.

<hr><h2>Member Function Documentation</h2>
<h3 class=fn><a name="TQEvent"></a>TQEvent::TQEvent ( <a href="tqevent.html#Type-enum">Type</a>&nbsp;type )
</h3>

<p> Contructs an event object of type <em>type</em>.

<h3 class=fn><a name="~TQEvent"></a>TQEvent::~TQEvent ()<tt> [virtual]</tt>
</h3>
Destroys the event. If it was <a href="ntqapplication.html#postEvent">posted</a>,
it will be removed from the list of events to be posted.

<h3 class=fn>bool <a name="spontaneous"></a>TQEvent::spontaneous () const
</h3>

<p> Returns TRUE if the event originated outside the application, i.e.
it is a system event; otherwise returns FALSE.

<h3 class=fn><a href="tqevent.html#Type-enum">Type</a> <a name="type"></a>TQEvent::type () const
</h3>

<p> Returns the event type.

<!-- eof -->
<hr><p>
This file is part of the <a href="index.html">TQt toolkit</a>.
Copyright &copy; 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 &copy; 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>