<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qabstracteventdispatcher.cpp -->
<title>Qt 4.8: QAbstractEventDispatcher Class Reference</title>
<link rel="stylesheet" type="text/css" href="style/style.css" />
<script src="scripts/jquery.js" type="text/javascript"></script>
<script src="scripts/functions.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="style/superfish.css" />
<link rel="stylesheet" type="text/css" href="style/narrow.css" />
<!--[if IE]>
<meta name="MSSmartTagsPreventParsing" content="true">
<meta http-equiv="imagetoolbar" content="no">
<![endif]-->
<!--[if lt IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie6.css">
<![endif]-->
<!--[if IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie7.css">
<![endif]-->
<!--[if IE 8]>
<link rel="stylesheet" type="text/css" href="style/style_ie8.css">
<![endif]-->
<script src="scripts/superfish.js" type="text/javascript"></script>
<script src="scripts/narrow.js" type="text/javascript"></script>
</head>
<body class="" onload="CheckEmptyAndLoadList();">
<div class="header" id="qtdocheader">
<div class="content">
<div id="nav-logo">
<a href="index.html">Home</a></div>
<a href="index.html" class="qtref"><span>Qt Reference Documentation</span></a>
<div id="narrowsearch"></div>
<div id="nav-topright">
<ul>
<li class="nav-topright-home"><a href="http://qt.digia.com/">Qt HOME</a></li>
<li class="nav-topright-dev"><a href="http://qt-project.org/">DEV</a></li>
<li class="nav-topright-doc nav-topright-doc-active"><a href="http://qt-project.org/doc/">
DOC</a></li>
<li class="nav-topright-blog"><a href="http://blog.qt.digia.com/">BLOG</a></li>
</ul>
</div>
<div id="shortCut">
<ul>
<li class="shortCut-topleft-inactive"><span><a href="index.html">Qt 4.8</a></span></li>
<li class="shortCut-topleft-active"><a href="http://qt-project.org/doc/">ALL VERSIONS </a></li>
</ul>
</div>
<ul class="sf-menu" id="narrowmenu">
<li><a href="#">API Lookup</a>
<ul>
<li><a href="classes.html">Class index</a></li>
<li><a href="functions.html">Function index</a></li>
<li><a href="modules.html">Modules</a></li>
<li><a href="namespaces.html">Namespaces</a></li>
<li><a href="qtglobal.html">Global Declarations</a></li>
<li><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</li>
<li><a href="#">Qt Topics</a>
<ul>
<li><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li><a href="supported-platforms.html">Supported Platforms</a></li>
<li><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</li>
<li><a href="#">Examples</a>
<ul>
<li><a href="all-examples.html">Examples</a></li>
<li><a href="tutorials.html">Tutorials</a></li>
<li><a href="demos.html">Demos</a></li>
<li><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div class="wrapper">
<div class="hd">
<span></span>
</div>
<div class="bd group">
<div class="sidebar">
<div class="searchlabel">
Search index:</div>
<div class="search" id="sidebarsearch">
<form id="qtdocsearch" action="" onsubmit="return false;">
<fieldset>
<input type="text" name="searchstring" id="pageType" value="" />
<div id="resultdialog">
<a href="#" id="resultclose">Close</a>
<p id="resultlinks" class="all"><a href="#" id="showallresults">All</a> | <a href="#" id="showapiresults">API</a> | <a href="#" id="showarticleresults">Articles</a> | <a href="#" id="showexampleresults">Examples</a></p>
<p id="searchcount" class="all"><span id="resultcount"></span><span id="apicount"></span><span id="articlecount"></span><span id="examplecount"></span> results:</p>
<ul id="resultlist" class="all">
</ul>
</div>
</fieldset>
</form>
</div>
<div class="box first bottombar" id="lookup">
<h2 title="API Lookup"><span></span>
API Lookup</h2>
<div id="list001" class="list">
<ul id="ul001" >
<li class="defaultLink"><a href="classes.html">Class index</a></li>
<li class="defaultLink"><a href="functions.html">Function index</a></li>
<li class="defaultLink"><a href="modules.html">Modules</a></li>
<li class="defaultLink"><a href="namespaces.html">Namespaces</a></li>
<li class="defaultLink"><a href="qtglobal.html">Global Declarations</a></li>
<li class="defaultLink"><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</div>
</div>
<div class="box bottombar" id="topics">
<h2 title="Qt Topics"><span></span>
Qt Topics</h2>
<div id="list002" class="list">
<ul id="ul002" >
<li class="defaultLink"><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li class="defaultLink"><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li class="defaultLink"><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li class="defaultLink"><a href="supported-platforms.html">Supported Platforms</a></li>
<li class="defaultLink"><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li class="defaultLink"><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</div>
</div>
<div class="box" id="examples">
<h2 title="Examples"><span></span>
Examples</h2>
<div id="list003" class="list">
<ul id="ul003">
<li class="defaultLink"><a href="all-examples.html">Examples</a></li>
<li class="defaultLink"><a href="tutorials.html">Tutorials</a></li>
<li class="defaultLink"><a href="demos.html">Demos</a></li>
<li class="defaultLink"><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</div>
</div>
</div>
<div class="wrap">
<div class="toolbar">
<div class="breadcrumb toolblock">
<ul>
<li class="first"><a href="index.html">Home</a></li>
<!-- Breadcrumbs go here -->
<li><a href="modules.html">Modules</a></li>
<li><a href="qtcore.html">QtCore</a></li>
<li>QAbstractEventDispatcher</li>
</ul>
</div>
<div class="toolbuttons toolblock">
<ul>
<li id="smallA" class="t_button">A</li>
<li id="medA" class="t_button active">A</li>
<li id="bigA" class="t_button">A</li>
<li id="print" class="t_button"><a href="javascript:this.print();">
<span>Print</span></a></li>
</ul>
</div>
</div>
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#public-types">Public Types</a></li>
<li class="level1"><a href="#public-functions">Public Functions</a></li>
<li class="level1"><a href="#signals">Signals</a></li>
<li class="level1"><a href="#static-public-members">Static Public Members</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">QAbstractEventDispatcher Class Reference</h1>
<!-- $$$QAbstractEventDispatcher-brief -->
<p>The QAbstractEventDispatcher class provides an interface to manage Qt's event queue. <a href="#details">More...</a></p>
<!-- @@@QAbstractEventDispatcher -->
<pre class="cpp"> <span class="preprocessor">#include <QAbstractEventDispatcher></span></pre><p><b>Inherits: </b><a href="qobject.html">QObject</a>.</p>
<ul>
<li><a href="qabstracteventdispatcher-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="public-types"></a>
<h2>Public Types</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> typedef </td><td class="memItemRight bottomAlign"><b><a href="qabstracteventdispatcher.html#EventFilter-typedef">EventFilter</a></b></td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> typedef </td><td class="memItemRight bottomAlign"><b><a href="qabstracteventdispatcher.html#TimerInfo-typedef">TimerInfo</a></b></td></tr>
</table>
<a name="public-functions"></a>
<h2>Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qabstracteventdispatcher.html#QAbstractEventDispatcher">QAbstractEventDispatcher</a></b> ( QObject * <i>parent</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qabstracteventdispatcher.html#dtor.QAbstractEventDispatcher">~QAbstractEventDispatcher</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qabstracteventdispatcher.html#filterEvent">filterEvent</a></b> ( void * <i>message</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qabstracteventdispatcher.html#flush">flush</a></b> () = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qabstracteventdispatcher.html#hasPendingEvents">hasPendingEvents</a></b> () = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qabstracteventdispatcher.html#interrupt">interrupt</a></b> () = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qabstracteventdispatcher.html#processEvents">processEvents</a></b> ( QEventLoop::ProcessEventsFlags <i>flags</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qabstracteventdispatcher.html#registerSocketNotifier">registerSocketNotifier</a></b> ( QSocketNotifier * <i>notifier</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qabstracteventdispatcher.html#registerTimer">registerTimer</a></b> ( int <i>interval</i>, QObject * <i>object</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qabstracteventdispatcher.html#registerTimer-2">registerTimer</a></b> ( int <i>timerId</i>, int <i>interval</i>, QObject * <i>object</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QList<TimerInfo> </td><td class="memItemRight bottomAlign"><b><a href="qabstracteventdispatcher.html#registeredTimers">registeredTimers</a></b> ( QObject * <i>object</i> ) const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> EventFilter </td><td class="memItemRight bottomAlign"><b><a href="qabstracteventdispatcher.html#setEventFilter">setEventFilter</a></b> ( EventFilter <i>filter</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qabstracteventdispatcher.html#unregisterSocketNotifier">unregisterSocketNotifier</a></b> ( QSocketNotifier * <i>notifier</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qabstracteventdispatcher.html#unregisterTimer">unregisterTimer</a></b> ( int <i>timerId</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qabstracteventdispatcher.html#unregisterTimers">unregisterTimers</a></b> ( QObject * <i>object</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qabstracteventdispatcher.html#wakeUp">wakeUp</a></b> () = 0</td></tr>
</table>
<ul>
<li class="fn">29 public functions inherited from <a href="qobject.html#public-functions">QObject</a></li>
</ul>
<a name="signals"></a>
<h2>Signals</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qabstracteventdispatcher.html#aboutToBlock">aboutToBlock</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qabstracteventdispatcher.html#awake">awake</a></b> ()</td></tr>
</table>
<ul>
<li class="fn">1 signal inherited from <a href="qobject.html#signals">QObject</a></li>
</ul>
<a name="static-public-members"></a>
<h2>Static Public Members</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> QAbstractEventDispatcher * </td><td class="memItemRight bottomAlign"><b><a href="qabstracteventdispatcher.html#instance">instance</a></b> ( QThread * <i>thread</i> = 0 )</td></tr>
</table>
<ul>
<li class="fn">7 static public members inherited from <a href="qobject.html#static-public-members">QObject</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li class="fn">1 property inherited from <a href="qobject.html#properties">QObject</a></li>
<li class="fn">1 public slot inherited from <a href="qobject.html#public-slots">QObject</a></li>
<li class="fn">8 protected functions inherited from <a href="qobject.html#protected-functions">QObject</a></li>
</ul>
<a name="details"></a>
<!-- $$$QAbstractEventDispatcher-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QAbstractEventDispatcher class provides an interface to manage Qt's event queue.</p>
<p>An event dispatcher receives events from the window system and other sources. It then sends them to the <a href="qcoreapplication.html">QCoreApplication</a> or <a href="qapplication.html">QApplication</a> instance for processing and delivery. QAbstractEventDispatcher provides fine-grained control over event delivery.</p>
<p>For simple control of event processing use <a href="qcoreapplication.html#processEvents">QCoreApplication::processEvents</a>().</p>
<p>For finer control of the application's event loop, call <a href="qabstracteventdispatcher.html#instance">instance</a>() and call functions on the QAbstractEventDispatcher object that is returned. If you want to use your own instance of QAbstractEventDispatcher or of a QAbstractEventDispatcher subclass, you must create your instance <i>before</i> you create the <a href="qapplication.html">QApplication</a> object.</p>
<p>The main event loop is started by calling <a href="qcoreapplication.html#exec">QCoreApplication::exec</a>(), and stopped by calling <a href="qcoreapplication.html#exit">QCoreApplication::exit</a>(). Local event loops can be created using <a href="qeventloop.html">QEventLoop</a>.</p>
<p>Programs that perform long operations can call <a href="qabstracteventdispatcher.html#processEvents">processEvents</a>() with a bitwise OR combination of various <a href="qeventloop.html#ProcessEventsFlag-enum">QEventLoop::ProcessEventsFlag</a> values to control which events should be delivered.</p>
<p>QAbstractEventDispatcher also allows the integration of an external event loop with the Qt event loop. For example, the <a href="ftp://ftp.qt.nokia.com/pub/qt/solutions/lgpl/qtmotifextension-2.7_1-opensource.tar.gz">Motif Extension</a> includes a reimplementation of QAbstractEventDispatcher that merges Qt and Motif events together.</p>
</div>
<p><b>See also </b><a href="qeventloop.html">QEventLoop</a> and <a href="qcoreapplication.html">QCoreApplication</a>.</p>
<!-- @@@QAbstractEventDispatcher -->
<div class="types">
<h2>Member Type Documentation</h2>
<!-- $$$EventFilter -->
<h3 class="fn"><a name="EventFilter-typedef"></a>typedef QAbstractEventDispatcher::<span class="name">EventFilter</span></h3>
<p>Typedef for a function with the signature</p>
<pre class="cpp"> <span class="type">bool</span> myEventFilter(<span class="type">void</span> <span class="operator">*</span>message);</pre>
<p>Note that the type of the <i>message</i> is platform dependent. The following table shows the <i>message</i>'s type on Windows, Mac, X11 and BlackBerry. You can do a static cast to these types.</p>
<table class="generic">
<thead><tr class="qt-style"><th >Platform</th><th >type</th></tr></thead>
<tr valign="top" class="odd"><td >Windows</td><td >MSG</td></tr>
<tr valign="top" class="even"><td >X11</td><td >XEvent</td></tr>
<tr valign="top" class="odd"><td >Mac</td><td >NSEvent</td></tr>
<tr valign="top" class="even"><td >BlackBerry</td><td >bps_event_t</td></tr>
</table>
<p><b>See also </b><a href="qabstracteventdispatcher.html#setEventFilter">setEventFilter</a>() and <a href="qabstracteventdispatcher.html#filterEvent">filterEvent</a>().</p>
<!-- @@@EventFilter -->
<!-- $$$TimerInfo -->
<h3 class="fn"><a name="TimerInfo-typedef"></a>typedef QAbstractEventDispatcher::<span class="name">TimerInfo</span></h3>
<p>Typedef for <a href="qpair.html">QPair</a><int, int>. The first component of the pair is the timer ID; the second component is the interval.</p>
<p><b>See also </b><a href="qabstracteventdispatcher.html#registeredTimers">registeredTimers</a>().</p>
<!-- @@@TimerInfo -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QAbstractEventDispatcher[overload1]$$$QAbstractEventDispatcherQObject* -->
<h3 class="fn"><a name="QAbstractEventDispatcher"></a>QAbstractEventDispatcher::<span class="name">QAbstractEventDispatcher</span> ( <span class="type"><a href="qobject.html">QObject</a></span> * <i>parent</i> = 0 )</h3>
<p>Constructs a new event dispatcher with the given <i>parent</i>.</p>
<!-- @@@QAbstractEventDispatcher -->
<!-- $$$~QAbstractEventDispatcher[overload1]$$$~QAbstractEventDispatcher -->
<h3 class="fn"><a name="dtor.QAbstractEventDispatcher"></a>QAbstractEventDispatcher::<span class="name">~QAbstractEventDispatcher</span> ()</h3>
<p>Destroys the event dispatcher.</p>
<!-- @@@~QAbstractEventDispatcher -->
<!-- $$$aboutToBlock[overload1]$$$aboutToBlock -->
<h3 class="fn"><a name="aboutToBlock"></a><span class="type">void</span> QAbstractEventDispatcher::<span class="name">aboutToBlock</span> ()<tt> [signal]</tt></h3>
<p>This signal is emitted before the event loop calls a function that could block.</p>
<p><b>See also </b><a href="qabstracteventdispatcher.html#awake">awake</a>().</p>
<!-- @@@aboutToBlock -->
<!-- $$$awake[overload1]$$$awake -->
<h3 class="fn"><a name="awake"></a><span class="type">void</span> QAbstractEventDispatcher::<span class="name">awake</span> ()<tt> [signal]</tt></h3>
<p>This signal is emitted after the event loop returns from a function that could block.</p>
<p><b>See also </b><a href="qabstracteventdispatcher.html#wakeUp">wakeUp</a>() and <a href="qabstracteventdispatcher.html#aboutToBlock">aboutToBlock</a>().</p>
<!-- @@@awake -->
<!-- $$$filterEvent[overload1]$$$filterEventvoid* -->
<h3 class="fn"><a name="filterEvent"></a><span class="type">bool</span> QAbstractEventDispatcher::<span class="name">filterEvent</span> ( <span class="type">void</span> * <i>message</i> )</h3>
<p>Sends <i>message</i> through the event filter that was set by <a href="qabstracteventdispatcher.html#setEventFilter">setEventFilter</a>(). If no event filter has been set, this function returns false; otherwise, this function returns the result of the event filter function.</p>
<p>Subclasses of <a href="qabstracteventdispatcher.html">QAbstractEventDispatcher</a> <i>must</i> call this function for <i>all</i> messages received from the system to ensure compatibility with any extensions that may be used in the application.</p>
<p>Note that the type of <i>message</i> is platform dependent. See <a href="qabstracteventdispatcher.html#EventFilter-typedef">QAbstractEventDispatcher::EventFilter</a> for details.</p>
<p><b>See also </b><a href="qabstracteventdispatcher.html#setEventFilter">setEventFilter</a>().</p>
<!-- @@@filterEvent -->
<!-- $$$flush[overload1]$$$flush -->
<h3 class="fn"><a name="flush"></a><span class="type">void</span> QAbstractEventDispatcher::<span class="name">flush</span> ()<tt> [pure virtual]</tt></h3>
<p>Flushes the event queue. This normally returns almost immediately. Does nothing on platforms other than X11.</p>
<!-- @@@flush -->
<!-- $$$hasPendingEvents[overload1]$$$hasPendingEvents -->
<h3 class="fn"><a name="hasPendingEvents"></a><span class="type">bool</span> QAbstractEventDispatcher::<span class="name">hasPendingEvents</span> ()<tt> [pure virtual]</tt></h3>
<p>Returns true if there is an event waiting; otherwise returns false.</p>
<!-- @@@hasPendingEvents -->
<!-- $$$instance[overload1]$$$instanceQThread* -->
<h3 class="fn"><a name="instance"></a><span class="type">QAbstractEventDispatcher</span> * QAbstractEventDispatcher::<span class="name">instance</span> ( <span class="type"><a href="qthread.html">QThread</a></span> * <i>thread</i> = 0 )<tt> [static]</tt></h3>
<p>Returns a pointer to the event dispatcher object for the specified <i>thread</i>. If <i>thread</i> is zero, the current thread is used. If no event dispatcher exists for the specified thread, this function returns 0.</p>
<p><b>Note:</b> If Qt is built without thread support, the <i>thread</i> argument is ignored.</p>
<!-- @@@instance -->
<!-- $$$interrupt[overload1]$$$interrupt -->
<h3 class="fn"><a name="interrupt"></a><span class="type">void</span> QAbstractEventDispatcher::<span class="name">interrupt</span> ()<tt> [pure virtual]</tt></h3>
<p>Interrupts event dispatching; i.e. the event dispatcher will return from <a href="qabstracteventdispatcher.html#processEvents">processEvents</a>() as soon as possible.</p>
<!-- @@@interrupt -->
<!-- $$$processEvents[overload1]$$$processEventsQEventLoop::ProcessEventsFlags -->
<h3 class="fn"><a name="processEvents"></a><span class="type">bool</span> QAbstractEventDispatcher::<span class="name">processEvents</span> ( <span class="type"><a href="qeventloop.html#ProcessEventsFlag-enum">QEventLoop::ProcessEventsFlags</a></span> <i>flags</i> )<tt> [pure virtual]</tt></h3>
<p>Processes pending events that match <i>flags</i> until there are no more events to process. Returns true if an event was processed; otherwise returns false.</p>
<p>This function is especially useful if you have a long running operation and want to show its progress without allowing user input; i.e. by using the <a href="qeventloop.html#ProcessEventsFlag-enum">QEventLoop::ExcludeUserInputEvents</a> flag.</p>
<p>If the <a href="qeventloop.html#ProcessEventsFlag-enum">QEventLoop::WaitForMoreEvents</a> flag is set in <i>flags</i>, the behavior of this function is as follows:</p>
<ul>
<li>If events are available, this function returns after processing them.</li>
<li>If no events are available, this function will wait until more are available and return after processing newly available events.</li>
</ul>
<p>If the <a href="qeventloop.html#ProcessEventsFlag-enum">QEventLoop::WaitForMoreEvents</a> flag is not set in <i>flags</i>, and no events are available, this function will return immediately.</p>
<p><b>Note:</b> This function does not process events continuously; it returns after all available events are processed.</p>
<p><b>See also </b><a href="qabstracteventdispatcher.html#hasPendingEvents">hasPendingEvents</a>().</p>
<!-- @@@processEvents -->
<!-- $$$registerSocketNotifier[overload1]$$$registerSocketNotifierQSocketNotifier* -->
<h3 class="fn"><a name="registerSocketNotifier"></a><span class="type">void</span> QAbstractEventDispatcher::<span class="name">registerSocketNotifier</span> ( <span class="type"><a href="qsocketnotifier.html">QSocketNotifier</a></span> * <i>notifier</i> )<tt> [pure virtual]</tt></h3>
<p>Registers <i>notifier</i> with the event loop. Subclasses must implement this method to tie a socket notifier into another event loop.</p>
<!-- @@@registerSocketNotifier -->
<!-- $$$registerTimer[overload1]$$$registerTimerintQObject* -->
<h3 class="fn"><a name="registerTimer"></a><span class="type">int</span> QAbstractEventDispatcher::<span class="name">registerTimer</span> ( <span class="type">int</span> <i>interval</i>, <span class="type"><a href="qobject.html">QObject</a></span> * <i>object</i> )</h3>
<p>Registers a timer with the specified <i>interval</i> for the given <i>object</i>.</p>
<!-- @@@registerTimer -->
<!-- $$$registerTimer$$$registerTimerintintQObject* -->
<h3 class="fn"><a name="registerTimer-2"></a><span class="type">void</span> QAbstractEventDispatcher::<span class="name">registerTimer</span> ( <span class="type">int</span> <i>timerId</i>, <span class="type">int</span> <i>interval</i>, <span class="type"><a href="qobject.html">QObject</a></span> * <i>object</i> )<tt> [pure virtual]</tt></h3>
<p>Register a timer with the specified <i>timerId</i> and <i>interval</i> for the given <i>object</i>.</p>
<!-- @@@registerTimer -->
<!-- $$$registeredTimers[overload1]$$$registeredTimersQObject* -->
<h3 class="fn"><a name="registeredTimers"></a><span class="type"><a href="qlist.html">QList</a></span><<span class="type"><a href="qabstracteventdispatcher.html#TimerInfo-typedef">TimerInfo</a></span>> QAbstractEventDispatcher::<span class="name">registeredTimers</span> ( <span class="type"><a href="qobject.html">QObject</a></span> * <i>object</i> ) const<tt> [pure virtual]</tt></h3>
<p>Returns a list of registered timers for <i>object</i>. The timer ID is the first member in each pair; the interval is the second.</p>
<!-- @@@registeredTimers -->
<!-- $$$setEventFilter[overload1]$$$setEventFilterEventFilter -->
<h3 class="fn"><a name="setEventFilter"></a><span class="type"><a href="qabstracteventdispatcher.html#EventFilter-typedef">EventFilter</a></span> QAbstractEventDispatcher::<span class="name">setEventFilter</span> ( <span class="type"><a href="qabstracteventdispatcher.html#EventFilter-typedef">EventFilter</a></span> <i>filter</i> )</h3>
<p>Replaces the event filter function for this <a href="qabstracteventdispatcher.html">QAbstractEventDispatcher</a> with <i>filter</i> and returns the replaced event filter function. Only the current event filter function is called. If you want to use both filter functions, save the replaced <a href="qabstracteventdispatcher.html#EventFilter-typedef">EventFilter</a> in a place where yours can call it.</p>
<p>The event filter function set here is called for all messages taken from the system event loop before the event is dispatched to the respective target, including the messages not meant for Qt objects.</p>
<p>The event filter function should return true if the message should be filtered, (i.e. stopped). It should return false to allow processing the message to continue.</p>
<p>By default, no event filter function is set (i.e., this function returns a null <a href="qabstracteventdispatcher.html#EventFilter-typedef">EventFilter</a> the first time it is called).</p>
<!-- @@@setEventFilter -->
<!-- $$$unregisterSocketNotifier[overload1]$$$unregisterSocketNotifierQSocketNotifier* -->
<h3 class="fn"><a name="unregisterSocketNotifier"></a><span class="type">void</span> QAbstractEventDispatcher::<span class="name">unregisterSocketNotifier</span> ( <span class="type"><a href="qsocketnotifier.html">QSocketNotifier</a></span> * <i>notifier</i> )<tt> [pure virtual]</tt></h3>
<p>Unregisters <i>notifier</i> from the event dispatcher. Subclasses must reimplement this method to tie a socket notifier into another event loop. Reimplementations must call the base implementation.</p>
<!-- @@@unregisterSocketNotifier -->
<!-- $$$unregisterTimer[overload1]$$$unregisterTimerint -->
<h3 class="fn"><a name="unregisterTimer"></a><span class="type">bool</span> QAbstractEventDispatcher::<span class="name">unregisterTimer</span> ( <span class="type">int</span> <i>timerId</i> )<tt> [pure virtual]</tt></h3>
<p>Unregisters the timer with the given <i>timerId</i>. Returns true if successful; otherwise returns false.</p>
<p><b>See also </b><a href="qabstracteventdispatcher.html#registerTimer">registerTimer</a>() and <a href="qabstracteventdispatcher.html#unregisterTimers">unregisterTimers</a>().</p>
<!-- @@@unregisterTimer -->
<!-- $$$unregisterTimers[overload1]$$$unregisterTimersQObject* -->
<h3 class="fn"><a name="unregisterTimers"></a><span class="type">bool</span> QAbstractEventDispatcher::<span class="name">unregisterTimers</span> ( <span class="type"><a href="qobject.html">QObject</a></span> * <i>object</i> )<tt> [pure virtual]</tt></h3>
<p>Unregisters all the timers associated with the given <i>object</i>. Returns true if all timers were successful removed; otherwise returns false.</p>
<p><b>See also </b><a href="qabstracteventdispatcher.html#unregisterTimer">unregisterTimer</a>() and <a href="qabstracteventdispatcher.html#registeredTimers">registeredTimers</a>().</p>
<!-- @@@unregisterTimers -->
<!-- $$$wakeUp[overload1]$$$wakeUp -->
<h3 class="fn"><a name="wakeUp"></a><span class="type">void</span> QAbstractEventDispatcher::<span class="name">wakeUp</span> ()<tt> [pure virtual]</tt></h3>
<p>Wakes up the event loop.</p>
<p><b>Note:</b> This function is <a href="threads-reentrancy.html#thread-safe">thread-safe</a>.</p>
<p><b>See also </b><a href="qabstracteventdispatcher.html#awake">awake</a>().</p>
<!-- @@@wakeUp -->
</div>
</div>
</div>
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2013 Digia Plc and/or its
subsidiaries. Documentation contributions included herein are the copyrights of
their respective owners.</p>
<br />
<p>
The documentation provided herein is licensed under the terms of the
<a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation
License version 1.3</a> as published by the Free Software Foundation.</p>
<p>
Documentation sources may be obtained from <a href="http://www.qt-project.org">
www.qt-project.org</a>.</p>
<br />
<p>
Digia, Qt and their respective logos are trademarks of Digia Plc
in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. <a title="Privacy Policy"
href="http://en.gitorious.org/privacy_policy/">Privacy Policy</a></p>
</div>
<script src="scripts/functions.js" type="text/javascript"></script>
</body>
</html>
