/****************************************************************************

**

** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

** All rights reserved.

** Contact: Nokia Corporation (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 Technology Preview License Agreement accompanying

** this package.

**

** 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.1, included in the file LGPL_EXCEPTION.txt in this package.

**

** If you have questions regarding the use of this file, please contact

** Nokia at qt-info@nokia.com.

**

**

**

**

**

**

**

**

** $QT_END_LICENSE$

**

****************************************************************************/

#ifndef QAPPLICATION_H

#define QAPPLICATION_H

#include <QtCore/qcoreapplication.h>

#include <QtGui/qwindowdefs.h>

#include <QtCore/qpoint.h>

#include <QtCore/qsize.h>

#include <QtGui/qcursor.h>

#ifdef QT_INCLUDE_COMPAT

# include <QtGui/qdesktopwidget.h>

#endif

#ifdef QT3_SUPPORT

# include <QtGui/qwidget.h>

# include <QtGui/qpalette.h>

#endif

#ifdef Q_WS_QWS

# include <QtGui/qrgb.h>

# include <QtGui/qtransportauth_qws.h>

#endif

QT_BEGIN_HEADER

#if defined(Q_WS_S60)

class CApaApplication;

#endif

QT_BEGIN_NAMESPACE

QT_MODULE(Gui)

class QSessionManager;

class QDesktopWidget;

class QStyle;

class QEventLoop;

class QIcon;

class QInputContext;

template <typename T> class QList;

class QLocale;

#if defined(Q_WS_QWS)

class QDecoration;

#endif

#if defined(Q_OS_SYMBIAN)

class QSymbianEvent;

#endif

class QApplication;

class QApplicationPrivate;

#if defined(qApp)

#undef qApp

#endif

#define qApp (static_cast<QApplication *>(QCoreApplication::instance()))

class Q_GUI_EXPORT QApplication : public QCoreApplication

{

    Q_OBJECT

    Q_PROPERTY(Qt::LayoutDirection layoutDirection READ layoutDirection WRITE setLayoutDirection)

    Q_PROPERTY(QIcon windowIcon READ windowIcon WRITE setWindowIcon)

    Q_PROPERTY(int cursorFlashTime READ cursorFlashTime WRITE setCursorFlashTime)

    Q_PROPERTY(int doubleClickInterval  READ doubleClickInterval WRITE setDoubleClickInterval)

    Q_PROPERTY(int keyboardInputInterval READ keyboardInputInterval WRITE setKeyboardInputInterval)

#ifndef QT_NO_WHEELEVENT

    Q_PROPERTY(int wheelScrollLines  READ wheelScrollLines WRITE setWheelScrollLines)

#endif

    Q_PROPERTY(QSize globalStrut READ globalStrut WRITE setGlobalStrut)

    Q_PROPERTY(int startDragTime  READ startDragTime WRITE setStartDragTime)

    Q_PROPERTY(int startDragDistance  READ startDragDistance WRITE setStartDragDistance)

    Q_PROPERTY(bool quitOnLastWindowClosed  READ quitOnLastWindowClosed WRITE setQuitOnLastWindowClosed)

#ifndef QT_NO_STYLE_STYLESHEET

    Q_PROPERTY(QString styleSheet READ styleSheet WRITE setStyleSheet)

#endif

#ifdef Q_WS_WINCE

    Q_PROPERTY(int autoMaximizeThreshold READ autoMaximizeThreshold WRITE setAutoMaximizeThreshold)

#endif

    Q_PROPERTY(bool autoSipEnabled READ autoSipEnabled WRITE setAutoSipEnabled)

public:

    enum Type { Tty, GuiClient, GuiServer };

#ifdef Q_WS_S60

    typedef CApaApplication * (*QS60MainApplicationFactory)();

#endif

#ifndef qdoc

    QApplication(int &argc, char **argv, int = QT_VERSION);

    QApplication(int &argc, char **argv, bool GUIenabled, int = QT_VERSION);

    QApplication(int &argc, char **argv, Type, int = QT_VERSION);

#if defined(Q_WS_X11)

    QApplication(Display* dpy, Qt::HANDLE visual = 0, Qt::HANDLE cmap = 0, int = QT_VERSION);

    QApplication(Display *dpy, int &argc, char **argv, Qt::HANDLE visual = 0, Qt::HANDLE cmap= 0, int = QT_VERSION);

#endif

#if defined(Q_WS_S60)

    QApplication(QApplication::QS60MainApplicationFactory factory, int &argc, char **argv, int = QT_VERSION);

#endif

#endif

    virtual ~QApplication();

    static Type type();

    static QStyle *style();

    static void setStyle(QStyle*);

    static QStyle *setStyle(const QString&);

    enum ColorSpec { NormalColor=0, CustomColor=1, ManyColor=2 };

    static int colorSpec();

    static void setColorSpec(int);

    static void setGraphicsSystem(const QString &);

#ifndef QT_NO_CURSOR

    static QCursor *overrideCursor();

    static void setOverrideCursor(const QCursor &);

    static void changeOverrideCursor(const QCursor &);

    static void restoreOverrideCursor();

#endif

    static QPalette palette();

    static QPalette palette(const QWidget *);

    static QPalette palette(const char *className);

    static void setPalette(const QPalette &, const char* className = 0);

    static QFont font();

    static QFont font(const QWidget*);

    static QFont font(const char *className);

    static void setFont(const QFont &, const char* className = 0);

    static QFontMetrics fontMetrics();

    static void setWindowIcon(const QIcon &icon);

    static QIcon windowIcon();

#ifdef QT3_SUPPORT

    static QT3_SUPPORT QWidget *mainWidget();

    static QT3_SUPPORT void setMainWidget(QWidget *);

#endif

    static QWidgetList allWidgets();

    static QWidgetList topLevelWidgets();

    static QDesktopWidget *desktop();

    static QWidget *activePopupWidget();

    static QWidget *activeModalWidget();

#ifndef QT_NO_CLIPBOARD

    static QClipboard *clipboard();

#endif

    static QWidget *focusWidget();

    static QWidget *activeWindow();

    static void setActiveWindow(QWidget* act);

    static QWidget *widgetAt(const QPoint &p);

    static inline QWidget *widgetAt(int x, int y) { return widgetAt(QPoint(x, y)); }

    static QWidget *topLevelAt(const QPoint &p);

    static inline QWidget *topLevelAt(int x, int y)  { return topLevelAt(QPoint(x, y)); }

    static void syncX();

    static void beep();

    static void alert(QWidget *widget, int duration = 0);

    static Qt::KeyboardModifiers keyboardModifiers();

    static Qt::MouseButtons mouseButtons();

    static void setDesktopSettingsAware(bool);

    static bool desktopSettingsAware();

    static void setCursorFlashTime(int);

    static int cursorFlashTime();

    static void setDoubleClickInterval(int);

    static int doubleClickInterval();

    static void setKeyboardInputInterval(int);

    static int keyboardInputInterval();

#ifndef QT_NO_WHEELEVENT

    static void setWheelScrollLines(int);

    static int wheelScrollLines();

#endif

    static void setGlobalStrut(const QSize &);

    static QSize globalStrut();

    static void setStartDragTime(int ms);

    static int startDragTime();

    static void setStartDragDistance(int l);

    static int startDragDistance();

    static void setLayoutDirection(Qt::LayoutDirection direction);

    static Qt::LayoutDirection layoutDirection();

    static inline bool isRightToLeft() { return layoutDirection() == Qt::RightToLeft; }

    static inline bool isLeftToRight() { return layoutDirection() == Qt::LeftToRight; }

    static bool isEffectEnabled(Qt::UIEffect);

    static void setEffectEnabled(Qt::UIEffect, bool enable = true);

#if defined(Q_WS_MAC)

    virtual bool macEventFilter(EventHandlerCallRef, EventRef);

#endif

#if defined(Q_WS_X11)

    virtual bool x11EventFilter(XEvent *);

    virtual int x11ClientMessage(QWidget*, XEvent*, bool passive_only);

    int x11ProcessEvent(XEvent*);

#endif

#if defined(Q_OS_SYMBIAN)

    int symbianProcessEvent(const QSymbianEvent *event);

    virtual bool symbianEventFilter(const QSymbianEvent *event);

#endif

#if defined(Q_WS_QWS)

    virtual bool qwsEventFilter(QWSEvent *);

    int qwsProcessEvent(QWSEvent*);

    void qwsSetCustomColors(QRgb *colortable, int start, int numColors);

#ifndef QT_NO_QWS_MANAGER

    static QDecoration &qwsDecoration();

    static void qwsSetDecoration(QDecoration *);

    static QDecoration *qwsSetDecoration(const QString &decoration);

#endif

#endif

#if defined(Q_WS_WIN)

    void winFocus(QWidget *, bool);

    static void winMouseButtonUp();

#endif

#ifndef QT_NO_SESSIONMANAGER

    // session management

    bool isSessionRestored() const;

    QString sessionId() const;

    QString sessionKey() const;

    virtual void commitData(QSessionManager& sm);

    virtual void saveState(QSessionManager& sm);

#endif

    void setInputContext(QInputContext *);

    QInputContext *inputContext() const;

    static QLocale keyboardInputLocale();

    static Qt::LayoutDirection keyboardInputDirection();

    static int exec();

    bool notify(QObject *, QEvent *);

    static void setQuitOnLastWindowClosed(bool quit);

    static bool quitOnLastWindowClosed();

#ifdef QT_KEYPAD_NAVIGATION

    static Q_DECL_DEPRECATED void setKeypadNavigationEnabled(bool);

    static bool keypadNavigationEnabled();

    static void setNavigationMode(Qt::NavigationMode mode);

    static Qt::NavigationMode navigationMode();

#endif

Q_SIGNALS:

    void lastWindowClosed();

    void focusChanged(QWidget *old, QWidget *now);

    void fontDatabaseChanged();

#ifndef QT_NO_SESSIONMANAGER

    void commitDataRequest(QSessionManager &sessionManager);

    void saveStateRequest(QSessionManager &sessionManager);

#endif

public:

    QString styleSheet() const;

public Q_SLOTS:

#ifndef QT_NO_STYLE_STYLESHEET

    void setStyleSheet(const QString& sheet);

#endif

#ifdef Q_WS_WINCE

    void setAutoMaximizeThreshold(const int threshold);

    int autoMaximizeThreshold() const;

#endif

    void setAutoSipEnabled(const bool enabled);

    bool autoSipEnabled() const;

    static void closeAllWindows();

    static void aboutQt();

protected:

#if defined(Q_WS_QWS)

    void setArgs(int, char **);

#endif

    bool event(QEvent *);

    bool compressEvent(QEvent *, QObject *receiver, QPostEventList *);

#ifdef QT3_SUPPORT

public:

    static inline QT3_SUPPORT void setReverseLayout(bool b) { setLayoutDirection(b?Qt::RightToLeft:Qt::LeftToRight); }

    static inline bool QT3_SUPPORT reverseLayout() { return layoutDirection() == Qt::RightToLeft; }

    static QT3_SUPPORT Qt::Alignment horizontalAlignment(Qt::Alignment align);

    typedef int ColorMode;

    enum { NormalColors = NormalColor, CustomColors = CustomColor };

    static inline QT3_SUPPORT ColorMode colorMode() { return static_cast<ColorMode>(colorSpec()); }

    static inline QT3_SUPPORT void setColorMode(ColorMode mode) { setColorSpec(int(mode)); }

#if defined(Q_OS_WIN32) || defined(Q_OS_CYGWIN)

    static QT3_SUPPORT Qt::WindowsVersion winVersion() { return (Qt::WindowsVersion)QSysInfo::WindowsVersion; }

#endif

#if defined(Q_OS_MAC)

    static QT3_SUPPORT Qt::MacintoshVersion macVersion() { return (Qt::MacintoshVersion)QSysInfo::MacintoshVersion; }

#endif

#  ifndef QT_NO_CURSOR

    inline static  QT3_SUPPORT void setOverrideCursor(const QCursor &cursor, bool replace)

    { if (replace) changeOverrideCursor(cursor); else setOverrideCursor(cursor); }

#  endif

    inline static QT3_SUPPORT bool hasGlobalMouseTracking() {return true;}

    inline static QT3_SUPPORT void setGlobalMouseTracking(bool) {}

    inline static QT3_SUPPORT void flushX() { flush(); }

    static inline QT3_SUPPORT void setWinStyleHighlightColor(const QColor &c) {

        QPalette p(palette());

        p.setColor(QPalette::Highlight, c);

        setPalette(p);

    }

    static inline QT3_SUPPORT const QColor &winStyleHighlightColor()

        { return palette().color(QPalette::Active, QPalette::Highlight); }

    static inline QT3_SUPPORT void setPalette(const QPalette &pal, bool, const char* className = 0)

        { setPalette(pal, className); }

    static inline QT3_SUPPORT void setFont(const QFont &font, bool, const char* className = 0)

        { setFont(font, className); }

    static inline QT3_SUPPORT QWidget *widgetAt(int x, int y, bool child)

        { QWidget *w = widgetAt(x, y); return child ? w : (w ? w->window() : 0); }

    static inline QT3_SUPPORT QWidget *widgetAt(const QPoint &p, bool child)

        { QWidget *w = widgetAt(p); return child ? w : (w ? w->window() : 0); }

#endif // QT3_SUPPORT

#if defined(Q_INTERNAL_QAPP_SRC) || defined(qdoc)

    QApplication(int &argc, char **argv);

    QApplication(int &argc, char **argv, bool GUIenabled);

    QApplication(int &argc, char **argv, Type);

#if defined(Q_WS_X11)

    QApplication(Display* dpy, Qt::HANDLE visual = 0, Qt::HANDLE cmap = 0);

    QApplication(Display *dpy, int &argc, char **argv, Qt::HANDLE visual = 0, Qt::HANDLE cmap= 0);

#endif

#if defined(Q_WS_S60) || defined(qdoc)

    QApplication(QApplication::QS60MainApplicationFactory factory, int &argc, char **argv);

#endif

#endif

private:

    Q_DISABLE_COPY(QApplication)

    Q_DECLARE_PRIVATE(QApplication)

    friend class QGraphicsWidget;

    friend class QGraphicsScene;

    friend class QGraphicsScenePrivate;

    friend class QWidget;

    friend class QWidgetPrivate;

    friend class QETWidget;

    friend class Q3AccelManager;

    friend class QTranslator;

    friend class QWidgetAnimator;

#ifndef QT_NO_SHORTCUT

    friend class QShortcut;

    friend class QLineEdit;

    friend class QTextControl;

#endif

    friend class QAction;

    friend class QFontDatabasePrivate;

#if defined(Q_WS_QWS)

    friend class QInputContext;

    friend class QWSDirectPainterSurface;

    friend class QDirectPainter;

    friend class QDirectPainterPrivate;

#endif

    friend class QGestureManager;

#if defined(Q_WS_MAC) || defined(Q_WS_X11)

    Q_PRIVATE_SLOT(d_func(), void _q_alertTimeOut())

#endif

#if defined(QT_RX71_MULTITOUCH)

    Q_PRIVATE_SLOT(d_func(), void _q_readRX71MultiTouchEvents())

#endif

};

QT_END_NAMESPACE

QT_END_HEADER

#endif // QAPPLICATION_H