/**************************************************************************** ** ** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). ** Contact: http://www.qt-project.org/legal ** ** This file is part of the QtCore module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and Digia. For licensing terms and ** conditions see http://qt.digia.com/licensing. For further information ** use the contact form at http://qt.digia.com/contact-us. ** ** 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, Digia gives you certain additional ** rights. These rights are described in the Digia Qt LGPL Exception ** version 1.1, 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. ** ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #ifndef QCOREAPPLICATION_H #define QCOREAPPLICATION_H #include #include #include #if defined(Q_OS_WIN) && !defined(tagMSG) typedef struct tagMSG MSG; #endif QT_BEGIN_NAMESPACE class QCoreApplicationPrivate; class QTextCodec; class QTranslator; class QPostEventList; class QStringList; class QAbstractEventDispatcher; class QAbstractNativeEventFilter; #define qApp QCoreApplication::instance() class Q_CORE_EXPORT QCoreApplication : public QObject { Q_OBJECT Q_PROPERTY(QString applicationName READ applicationName WRITE setApplicationName) Q_PROPERTY(QString applicationVersion READ applicationVersion WRITE setApplicationVersion) Q_PROPERTY(QString organizationName READ organizationName WRITE setOrganizationName) Q_PROPERTY(QString organizationDomain READ organizationDomain WRITE setOrganizationDomain) Q_PROPERTY(bool quitLockEnabled READ isQuitLockEnabled WRITE setQuitLockEnabled) Q_DECLARE_PRIVATE(QCoreApplication) public: enum { ApplicationFlags = QT_VERSION }; QCoreApplication(int &argc, char **argv #ifndef Q_QDOC , int = ApplicationFlags #endif ); ~QCoreApplication(); static QStringList arguments(); static void setAttribute(Qt::ApplicationAttribute attribute, bool on = true); static bool testAttribute(Qt::ApplicationAttribute attribute); static void setOrganizationDomain(const QString &orgDomain); static QString organizationDomain(); static void setOrganizationName(const QString &orgName); static QString organizationName(); static void setApplicationName(const QString &application); static QString applicationName(); static void setApplicationVersion(const QString &version); static QString applicationVersion(); static QCoreApplication *instance() { return self; } static int exec(); static void processEvents(QEventLoop::ProcessEventsFlags flags = QEventLoop::AllEvents); static void processEvents(QEventLoop::ProcessEventsFlags flags, int maxtime); static void exit(int retcode=0); static bool sendEvent(QObject *receiver, QEvent *event); static void postEvent(QObject *receiver, QEvent *event, int priority = Qt::NormalEventPriority); static void sendPostedEvents(QObject *receiver = 0, int event_type = 0); static void removePostedEvents(QObject *receiver, int eventType = 0); static bool hasPendingEvents(); static QAbstractEventDispatcher *eventDispatcher(); static void setEventDispatcher(QAbstractEventDispatcher *eventDispatcher); virtual bool notify(QObject *, QEvent *); static bool startingUp(); static bool closingDown(); static QString applicationDirPath(); static QString applicationFilePath(); static qint64 applicationPid(); #ifndef QT_NO_LIBRARY static void setLibraryPaths(const QStringList &); static QStringList libraryPaths(); static void addLibraryPath(const QString &); static void removeLibraryPath(const QString &); #endif // QT_NO_LIBRARY #ifndef QT_NO_TRANSLATION static bool installTranslator(QTranslator * messageFile); static bool removeTranslator(QTranslator * messageFile); #endif static QString translate(const char * context, const char * key, const char * disambiguation = 0, int n = -1); #if QT_DEPRECATED_SINCE(5, 0) enum Encoding { UnicodeUTF8, Latin1, DefaultCodec = UnicodeUTF8, CodecForTr = UnicodeUTF8 }; QT_DEPRECATED static inline QString translate(const char * context, const char * key, const char * disambiguation, Encoding, int n = -1) { return translate(context, key, disambiguation, n); } #endif static void flush(); void installNativeEventFilter(QAbstractNativeEventFilter *filterObj); void removeNativeEventFilter(QAbstractNativeEventFilter *filterObj); static bool isQuitLockEnabled(); static void setQuitLockEnabled(bool enabled); public Q_SLOTS: static void quit(); Q_SIGNALS: void aboutToQuit( #if !defined(Q_QDOC) QPrivateSignal #endif ); protected: bool event(QEvent *); virtual bool compressEvent(QEvent *, QObject *receiver, QPostEventList *); protected: QCoreApplication(QCoreApplicationPrivate &p); private: static bool sendSpontaneousEvent(QObject *receiver, QEvent *event); bool notifyInternal(QObject *receiver, QEvent *event); void init(); static QCoreApplication *self; Q_DISABLE_COPY(QCoreApplication) friend class QEventDispatcherUNIXPrivate; friend class QApplication; friend class QApplicationPrivate; friend class QGuiApplication; friend class QGuiApplicationPrivate; friend class QETWidget; friend class QWidget; friend class QWidgetWindow; friend class QWidgetPrivate; friend class QCocoaEventDispatcherPrivate; friend bool qt_sendSpontaneousEvent(QObject*, QEvent*); friend Q_CORE_EXPORT QString qAppName(); friend class QClassFactory; }; inline bool QCoreApplication::sendEvent(QObject *receiver, QEvent *event) { if (event) event->spont = false; return self ? self->notifyInternal(receiver, event) : false; } inline bool QCoreApplication::sendSpontaneousEvent(QObject *receiver, QEvent *event) { if (event) event->spont = true; return self ? self->notifyInternal(receiver, event) : false; } #ifdef QT_NO_TRANSLATION inline QString QCoreApplication::translate(const char *, const char *sourceText, const char *, int) { return QString::fromUtf8(sourceText); } #endif #define Q_DECLARE_TR_FUNCTIONS(context) \ public: \ static inline QString tr(const char *sourceText, const char *disambiguation = 0, int n = -1) \ { return QCoreApplication::translate(#context, sourceText, disambiguation, n); } \ QT_DEPRECATED static inline QString trUtf8(const char *sourceText, const char *disambiguation = 0, int n = -1) \ { return QCoreApplication::translate(#context, sourceText, disambiguation, n); } \ private: typedef void (*QtStartUpFunction)(); typedef void (*QtCleanUpFunction)(); Q_CORE_EXPORT void qAddPreRoutine(QtStartUpFunction); Q_CORE_EXPORT void qAddPostRoutine(QtCleanUpFunction); Q_CORE_EXPORT void qRemovePostRoutine(QtCleanUpFunction); Q_CORE_EXPORT QString qAppName(); // get application name #define Q_COREAPP_STARTUP_FUNCTION(AFUNC) \ static void AFUNC ## _ctor_function() { \ qAddPreRoutine(AFUNC); \ } \ Q_CONSTRUCTOR_FUNCTION(AFUNC ## _ctor_function) #if defined(Q_OS_WIN) && !defined(QT_NO_DEBUG_STREAM) Q_CORE_EXPORT QString decodeMSG(const MSG &); Q_CORE_EXPORT QDebug operator<<(QDebug, const MSG &); #endif QT_END_NAMESPACE #endif // QCOREAPPLICATION_H