|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.trolltech.qt.QSignalEmitter
com.trolltech.qt.QtJambiObject
com.trolltech.qt.core.QObject
com.trolltech.qt.core.QAbstractEventDispatcher
public abstract class QAbstractEventDispatcher
The QAbstractEventDispatcher
class provides an interface to manage Qt's event queue. An event dispatcher receives events from the window system and other sources. It then sends them to the QCoreApplication
or QApplication
instance for processing and delivery. QAbstractEventDispatcher
provides fine-grained control over event delivery.
For simple control of event processing use QCoreApplication::processEvents()
.
For finer control of the application's event loop, call instance()
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 before you create the QApplication
object.
The main event loop is started by calling QCoreApplication::exec()
, and stopped by calling QCoreApplication::exit()
. Local event loops can be created using QEventLoop
.
Programs that perform long operations can call processEvents()
with a bitwise OR combination of various QEventLoop::ProcessEventsFlag
values to control which events should be delivered.
QAbstractEventDispatcher
also allows the integration of an external event loop with the Qt event loop. For example, the Motif Extension Qt Solution includes a reimplementation of QAbstractEventDispatcher
that merges Qt and Motif events together.
QEventLoop
, and QCoreApplication
.
Nested Class Summary |
---|
Nested classes/interfaces inherited from class com.trolltech.qt.QSignalEmitter |
---|
QSignalEmitter.Signal0, QSignalEmitter.Signal1, QSignalEmitter.Signal2, QSignalEmitter.Signal3, QSignalEmitter.Signal4, QSignalEmitter.Signal5, QSignalEmitter.Signal6, QSignalEmitter.Signal7, QSignalEmitter.Signal8, QSignalEmitter.Signal9 |
Field Summary | |
---|---|
QSignalEmitter.Signal0 |
aboutToBlock
This signal is emitted before the event loop calls a function that could block. |
QSignalEmitter.Signal0 |
awake
This signal is emitted after the event loop returns from a function that could block. |
Constructor Summary | |
---|---|
QAbstractEventDispatcher()
Constructs a new event dispatcher with the given parent. |
|
QAbstractEventDispatcher(QObject parent)
Constructs a new event dispatcher with the given parent. |
Method Summary | |
---|---|
abstract void |
flush()
Flushes the event queue. |
static QAbstractEventDispatcher |
fromNativePointer(QNativePointer nativePointer)
|
abstract boolean |
hasPendingEvents()
Returns true if there is an event waiting; otherwise returns false. |
static QAbstractEventDispatcher |
instance()
Returns a pointer to the event dispatcher object for the specified thread. |
static QAbstractEventDispatcher |
instance(java.lang.Thread thread)
Returns a pointer to the event dispatcher object for the specified thread. |
abstract void |
interrupt()
Interrupts event dispatching; i.e. |
abstract boolean |
processEvents(QEventLoop.ProcessEventsFlags flags)
Processes pending events that match flags until there are no more events to process. |
abstract java.util.List |
registeredTimers(QObject object)
Returns a list of registered timers for object. |
abstract void |
registerSocketNotifier(QSocketNotifier notifier)
Registers notifier with the event loop. |
abstract void |
registerTimer(int timerId,
int interval,
QObject object)
Register a timer with the specified timerId and interval for the given object. |
int |
registerTimer(int interval,
QObject object)
Registers a timer with the specified interval for the given object. |
abstract void |
unregisterSocketNotifier(QSocketNotifier notifier)
Unregisters notifier from the event dispatcher. |
abstract boolean |
unregisterTimer(int timerId)
Unregisters the timer with the given timerId. |
abstract boolean |
unregisterTimers(QObject object)
Unregisters all the timers associated with the given object. |
abstract void |
wakeUp()
Wakes up the event loop. |
Methods inherited from class com.trolltech.qt.core.QObject |
---|
childEvent, children, connectSlotsByName, customEvent, disposeLater, dumpObjectInfo, dumpObjectTree, dynamicPropertyNames, event, eventFilter, findChild, findChild, findChild, findChildren, findChildren, findChildren, findChildren, indexOfProperty, installEventFilter, isWidgetType, killTimer, moveToThread, objectName, parent, properties, property, removeEventFilter, setObjectName, setParent, setProperty, startTimer, timerEvent, toString, userProperty |
Methods inherited from class com.trolltech.qt.QtJambiObject |
---|
dispose, disposed, equals, finalize, reassignNativeResources, tr, tr, tr |
Methods inherited from class com.trolltech.qt.QSignalEmitter |
---|
blockSignals, disconnect, disconnect, signalsBlocked, signalSender, thread |
Methods inherited from class java.lang.Object |
---|
clone, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Methods inherited from interface com.trolltech.qt.QtJambiInterface |
---|
disableGarbageCollection, nativeId, nativePointer, reenableGarbageCollection, setJavaOwnership |
Field Detail |
---|
public final QSignalEmitter.Signal0 aboutToBlock
awake()
.
public final QSignalEmitter.Signal0 awake
wakeUp()
, and aboutToBlock()
.
Constructor Detail |
---|
public QAbstractEventDispatcher()
public QAbstractEventDispatcher(QObject parent)
Method Detail |
---|
public final int registerTimer(int interval, QObject object)
public abstract void flush()
public abstract boolean hasPendingEvents()
public abstract void interrupt()
processEvents()
as soon as possible.
public abstract boolean processEvents(QEventLoop.ProcessEventsFlags flags)
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 QEventLoop::ExcludeUserInputEvents
flag.
If the QEventLoop::WaitForMoreEvents
flag is set in flags, the behavior of this function is as follows:
QEventLoop::WaitForMoreEvents
flag is not set in flags, and no events are available, this function will return immediately. Note: This function does not process events continuously; it returns after all available events are processed.
hasPendingEvents()
.
public abstract void registerSocketNotifier(QSocketNotifier notifier)
public abstract void registerTimer(int timerId, int interval, QObject object)
public abstract java.util.List registeredTimers(QObject object)
public abstract void unregisterSocketNotifier(QSocketNotifier notifier)
public abstract boolean unregisterTimer(int timerId)
registerTimer()
, and unregisterTimers()
.
public abstract boolean unregisterTimers(QObject object)
unregisterTimer()
, and registeredTimers()
.
public abstract void wakeUp()
awake()
.
public static QAbstractEventDispatcher instance()
Note: If Qt is built without thread support, the thread argument is ignored.
public static QAbstractEventDispatcher instance(java.lang.Thread thread)
Note: If Qt is built without thread support, the thread argument is ignored.
public static QAbstractEventDispatcher fromNativePointer(QNativePointer nativePointer)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |