diff options
Diffstat (limited to 'src/gui/embedded/qwsevent_qws.cpp')
| -rw-r--r-- | src/gui/embedded/qwsevent_qws.cpp | 216 |
1 files changed, 216 insertions, 0 deletions
diff --git a/src/gui/embedded/qwsevent_qws.cpp b/src/gui/embedded/qwsevent_qws.cpp new file mode 100644 index 0000000..e23eacd --- /dev/null +++ b/src/gui/embedded/qwsevent_qws.cpp @@ -0,0 +1,216 @@ +/**************************************************************************** +** +** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies). +** Contact: Qt Software Information (qt-info@nokia.com) +** +** This file is part of the QtGui module of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:LGPL$ +** No Commercial Usage +** This file contains pre-release code and may not be distributed. +** You may use this file in accordance with the terms and conditions +** contained in the either Technology Preview License Agreement or the +** Beta Release License Agreement. +** +** GNU Lesser General Public License Usage +** Alternatively, this file may be used under the terms of the GNU Lesser +** General Public License version 2.1 as published by the Free Software +** Foundation and appearing in the file LICENSE.LGPL included in the +** packaging of this file. Please review the following information to +** ensure the GNU Lesser General Public License version 2.1 requirements +** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. +** +** In addition, as a special exception, Nokia gives you certain +** additional rights. These rights are described in the Nokia Qt LGPL +** Exception version 1.0, included in the file LGPL_EXCEPTION.txt in this +** package. +** +** GNU General Public License Usage +** Alternatively, this file may be used under the terms of the GNU +** General Public License version 3.0 as published by the Free Software +** Foundation and appearing in the file LICENSE.GPL included in the +** packaging of this file. Please review the following information to +** ensure the GNU General Public License version 3.0 requirements will be +** met: http://www.gnu.org/copyleft/gpl.html. +** +** If you are unsure which license is appropriate for your use, please +** contact the sales department at qt-sales@nokia.com. +** $QT_END_LICENSE$ +** +****************************************************************************/ + +#include "qwsevent_qws.h" + +QT_BEGIN_NAMESPACE + +QWSEvent *QWSEvent::factory(int type) +{ + QWSEvent *event = 0; + switch (type) { + case QWSEvent::Connected: + event = new QWSConnectedEvent; + break; + case QWSEvent::MaxWindowRect: + event = new QWSMaxWindowRectEvent; + break; + case QWSEvent::Mouse: + event = new QWSMouseEvent; + break; + case QWSEvent::Focus: + event = new QWSFocusEvent; + break; + case QWSEvent::Key: + event = new QWSKeyEvent; + break; + case QWSEvent::Region: + event = new QWSRegionEvent; + break; + case QWSEvent::Creation: + event = new QWSCreationEvent; + break; +#ifndef QT_NO_QWS_PROPERTIES + case QWSEvent::PropertyNotify: + event = new QWSPropertyNotifyEvent; + break; + case QWSEvent::PropertyReply: + event = new QWSPropertyReplyEvent; + break; +#endif // QT_NO_QWS_PROPERTIES + case QWSEvent::SelectionClear: + event = new QWSSelectionClearEvent; + break; + case QWSEvent::SelectionRequest: + event = new QWSSelectionRequestEvent; + break; + case QWSEvent::SelectionNotify: + event = new QWSSelectionNotifyEvent; + break; +#ifndef QT_NO_COP + case QWSEvent::QCopMessage: + event = new QWSQCopMessageEvent; + break; +#endif + case QWSEvent::WindowOperation: + event = new QWSWindowOperationEvent; + break; + +#ifndef QT_NO_QWS_INPUTMETHODS + case QWSEvent::IMEvent: + event = new QWSIMEvent; + break; + case QWSEvent::IMQuery: + event = new QWSIMQueryEvent; + break; + case QWSEvent::IMInit: + event = new QWSIMInitEvent; + break; +#endif +#ifndef QT_NO_QWSEMBEDWIDGET + case QWSEvent::Embed: + event = new QWSEmbedEvent; + break; +#endif + case QWSEvent::Font: + event = new QWSFontEvent; + break; + case QWSEvent::ScreenTransformation: + event = new QWSScreenTransformationEvent; + break; + default: + qCritical("QWSEvent::factory() : Unknown event type %08x!", type); + } + return event; +} + +/*! + \class QWSEvent + \ingroup qws + + \brief The QWSEvent class encapsulates an event in Qt for Embedded Linux. + + When running a \l{Qt for Embedded Linux} application, it either runs as a + server or connects to an existing server. All system generated + events are passed to the server application which then propagates + the event to the appropriate client. + + Whenever the server receives an event, it queries its stack of + top-level windows to find the window containing the event's + position. Each window can identify the client application that + created it, and returns its ID to the server upon + request. Finally, the server forwards the event, encapsulated by + an instance of the QWSEvent class, to the appropriate client. + + \image qt-embedded-client.png + + The server communicates with the client applications over the UNIX + domain socket. You can retrieve direct access to all the events a + client receives from the server, by reimplementing QApplication's + \l {QApplication::}{qwsEventFilter()} function. + + QWSEvent provides the \l Type enum specifying the origin of the + event. Internally, each type is represented by a QWSEvent + subclass, e.g., \c QWSKeyEvent. + + \sa QWSServer, QWSClient, {Qt for Embedded Linux Architecture} +*/ + +/*! + \enum QWSEvent::Type + + This enum describes the origin of the event. + + \value NoEvent No event has occurred. + \value Connected An application has connected to the server. + \value Mouse A mouse button is pressed or released, or the mouse cursor is moved. + See also \l{Qt for Embedded Linux Pointer Handling}. + \value Focus A window has lost or received focus. + \value Key A key is pressed or released. See also \l{Qt for Embedded Linux Character Input}. + \value Region A region has changed. + \value Creation The server has created an ID, typically for a window. + \value PropertyNotify A property has changed. + \value PropertyReply The server is responding to a request for a property's value. + \value SelectionClear A selection is deleted. + \value SelectionRequest The server has queried for a selection. + \value SelectionNotify A new selection has been created. + \value MaxWindowRect The server has changed the maximum window for an application. + \value QCopMessage A new Qt Cop message has appeared. See also QCopChannel + \value WindowOperation A window operation, e.g. resizing, has occurred. + \value IMEvent An input method has been used to enter text for languages with + non-Latin alphabets. See also QWSInputMethod. + \value IMQuery An input method query for a specified property has occurred. + See also QWSInputMethod. + \value NEvent The number of events has changed. + \value Embed An event used internally to implement embedded windows. See also + QWSEmbedWidget. + \value ScreenTransformation An event used internally to notify the client processes + that the screen has changed for example, rotation, etc. + \omitvalue Font + \omitvalue IMInit +*/ + +/*! + \fn QWSMouseEvent *QWSEvent::asMouse() + \internal +*/ + +/*! + \fn int QWSEvent::window() + \internal +*/ + +/*! + \fn int QWSEvent::window() const + \internal +*/ + +/*! + \fn QWSEvent *QWSEvent::factory(int type) + \internal +*/ + +/*! + \fn QWSEvent::QWSEvent( int t, int len, char * ptr) + \internal +*/ + +QT_END_NAMESPACE |