/**************************************************************************** ** ** Definition of QApplication class ** ** Created : 931107 ** ** Copyright (C) 1992-2008 Trolltech ASA. All rights reserved. ** ** This file is part of the kernel module of the Qt GUI Toolkit. ** ** This file may be used under the terms of the GNU General ** Public License versions 2.0 or 3.0 as published by the Free ** Software Foundation and appearing in the files LICENSE.GPL2 ** and LICENSE.GPL3 included in the packaging of this file. ** Alternatively you may (at your option) use any later version ** of the GNU General Public License if such license has been ** publicly approved by Trolltech ASA (or its successors, if any) ** and the KDE Free Qt Foundation. ** ** Please review the following information to ensure GNU General ** Public Licensing requirements will be met: ** http://trolltech.com/products/qt/licenses/licensing/opensource/. ** If you are unsure which license is appropriate for your use, please ** review the following information: ** http://trolltech.com/products/qt/licenses/licensing/licensingoverview ** or contact the sales department at sales@trolltech.com. ** ** This file may be used under the terms of the Q Public License as ** defined by Trolltech ASA and appearing in the file LICENSE.QPL ** included in the packaging of this file. Licensees holding valid Qt ** Commercial licenses may use this file in accordance with the Qt ** Commercial License Agreement provided with the Software. ** ** This file is provided "AS IS" with NO WARRANTY OF ANY KIND, ** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR ** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted ** herein. ** **********************************************************************/ #ifndef QAPPLICATION_H #define QAPPLICATION_H #ifndef QT_H #include "qdesktopwidget.h" #include "qasciidict.h" #include "qpalette.h" #include "qtranslator.h" #include "qstrlist.h" #include "qstringlist.h" #endif // QT_H class QSessionManager; class QStyle; class QTranslator; class QEventLoop; #if defined(Q_WS_X11) class QIMEvent; #endif #if defined(Q_WS_QWS) class QWSDecoration; #endif #ifdef QT_THREAD_SUPPORT class QMutex; class QThread; #endif // QT_THREAD_SUPPORT class QApplication; extern Q_EXPORT QApplication *qApp; // global application object class Q_EXPORT QApplication : public QObject { Q_OBJECT public: QApplication( int &argc, char **argv ); QApplication( int &argc, char **argv, bool GUIenabled ); enum Type { Tty, GuiClient, GuiServer }; QApplication( int &argc, char **argv, Type ); #if defined(Q_WS_X11) QApplication( Display* dpy, HANDLE visual = 0, HANDLE cmap = 0 ); QApplication( Display *dpy, int argc, char **argv, HANDLE visual = 0, HANDLE cmap= 0 ); #endif virtual ~QApplication(); int argc() const; char **argv() const; Type type() const; #ifndef QT_NO_STYLE static QStyle &style(); static void setStyle( QStyle* ); static QStyle* setStyle( const QString& ); #endif #ifndef Q_QDOC enum ColorMode { NormalColors, CustomColors }; static ColorMode colorMode(); static void setColorMode( QApplication::ColorMode ); #endif enum ColorSpec { NormalColor=0, CustomColor=1, ManyColor=2 }; static int colorSpec(); static void setColorSpec( int ); #ifndef QT_NO_CURSOR static QCursor *overrideCursor(); static void setOverrideCursor( const QCursor &, bool replace=FALSE ); static void restoreOverrideCursor(); #endif static bool hasGlobalMouseTracking(); static void setGlobalMouseTracking( bool enable ); #ifndef QT_NO_PALETTE static QPalette palette( const QWidget* = 0 ); static QPalette palette( QStringList ); static void setPalette( const QPalette &, bool informWidgets=FALSE, const char* className = 0 ); #endif static QFont font( const QWidget* = 0 ); static void setFont( const QFont &, bool informWidgets=FALSE, const char* className = 0 ); static QFontMetrics fontMetrics(); QWidget *mainWidget() const; virtual void setMainWidget( QWidget * ); virtual void polish( QWidget * ); static QWidgetList *allWidgets(); static QWidgetList *topLevelWidgets(); static QDesktopWidget *desktop(); static QWidget *activePopupWidget(); static QWidget *activeModalWidget(); #ifndef QT_NO_CLIPBOARD static QClipboard *clipboard(); #endif QWidget *focusWidget() const; QWidget *activeWindow() const; static QWidget *widgetAt( int x, int y, bool child=FALSE ); static QWidget *widgetAt( const QPoint &, bool child=FALSE ); static QEventLoop *eventLoop(); int exec(); void processEvents(); void processEvents( int maxtime ); void processOneEvent(); bool hasPendingEvents(); int enter_loop(); void exit_loop(); int loopLevel() const; static void exit( int retcode=0 ); static bool sendEvent( QObject *receiver, QEvent *event ); static void postEvent( QObject *receiver, QEvent *event ); static void sendPostedEvents( QObject *receiver, int event_type ); static void sendPostedEvents(); static void removePostedEvents( QObject *receiver ); virtual bool notify( QObject *, QEvent * ); static bool startingUp(); static bool closingDown(); static void flushX(); static void flush(); static void syncX(); static void beep(); #ifndef QT_NO_TRANSLATION # ifndef QT_NO_TEXTCODEC void setDefaultCodec( QTextCodec * ); QTextCodec* defaultCodec() const; # endif void installTranslator( QTranslator * ); void removeTranslator( QTranslator * ); #endif enum Encoding { DefaultCodec, UnicodeUTF8 }; QString translate( const char * context, const char * key, const char * comment = 0, Encoding encoding = DefaultCodec ) const; #ifndef QT_NO_DIR QString applicationDirPath(); QString applicationFilePath(); #endif #ifndef QT_NO_PALETTE // obsolete functions static void setWinStyleHighlightColor( const QColor &c ) { QPalette p( palette() ); p.setColor( QColorGroup::Highlight, c ); setPalette( p, TRUE); } static const QColor &winStyleHighlightColor() { return palette().active().highlight(); } #endif static void setDesktopSettingsAware( bool ); static bool desktopSettingsAware(); static void setCursorFlashTime( int ); static int cursorFlashTime(); static void setDoubleClickInterval( int ); static int doubleClickInterval(); #ifndef QT_NO_WHEELEVENT static void setWheelScrollLines( int ); static int wheelScrollLines(); #endif static void setGlobalStrut( const QSize & ); static QSize globalStrut(); #ifndef QT_NO_COMPONENT static void setLibraryPaths( const QStringList & ); static QStringList libraryPaths(); static void addLibraryPath( const QString & ); static void removeLibraryPath( const QString & ); #endif // QT_NO_COMPONENT static void setStartDragTime( int ms ); static int startDragTime(); static void setStartDragDistance( int l ); static int startDragDistance(); static void setReverseLayout( bool b ); static bool reverseLayout(); static int horizontalAlignment( int align ); 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_WIN) virtual bool winEventFilter( MSG * ); #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_WS_QWS) virtual bool qwsEventFilter( QWSEvent * ); int qwsProcessEvent( QWSEvent* ); void qwsSetCustomColors( QRgb *colortable, int start, int numColors ); /*! \internal Returns true if the process is GUI server */ bool qwsIsGUIServer(); #ifndef QT_NO_QWS_MANAGER static QWSDecoration &qwsDecoration(); static void qwsSetDecoration( QWSDecoration *); #endif #endif #if defined(Q_OS_WIN32) || defined(Q_OS_CYGWIN) static WindowsVersion winVersion(); #elif defined(Q_OS_MAC) static MacintoshVersion macVersion(); #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 #if defined(Q_WS_X11) #if !defined(QT_NO_IM_EXTENSIONS) virtual QWidget *locateICHolderWidget( QWidget *w ); virtual QWidgetList *icHolderWidgets(); static void create_im(); static void close_im(); #else QWidget *locateICHolderWidget( QWidget *w ); QWidgetList *icHolderWidgets(); static void create_xim(); static void close_xim(); #endif static QString defaultInputMethod(); void changeAllInputContext( const QString & ); static bool x11_apply_settings(); #endif void wakeUpGuiThread(); #if defined(QT_THREAD_SUPPORT) void lock(); void unlock(bool wakeUpGui = TRUE); bool locked(); bool tryLock(); #endif signals: void lastWindowClosed(); void aboutToQuit(); void guiThreadAwake(); public slots: void quit(); void closeAllWindows(); void aboutQt(); #if defined(Q_WS_QWS) protected: void setArgs(int, char **); #endif protected: bool event(QEvent *); private: void construct( int &argc, char **argv, Type ); void initialize( int, char ** ); void init_precmdline(); void process_cmdline( int* argcptr, char ** argv ); bool internalNotify( QObject *, QEvent * ); #if defined(Q_WS_QWS) static QWidget *findChildWidget( const QWidget *p, const QPoint &pos ); static QWidget *findWidget( const QObjectList&, const QPoint &, bool rec ); #endif #if defined(Q_WS_MAC) bool do_mouse_down(Point *, bool *); static QMAC_PASCAL OSStatus globalEventProcessor(EventHandlerCallRef, EventRef, void *); static QMAC_PASCAL OSStatus globalAppleEventProcessor(const AppleEvent *, AppleEvent *, long); static QMAC_PASCAL void qt_context_timer_callbk(EventLoopTimerRef, void *); static QMAC_PASCAL void qt_select_timer_callbk(EventLoopTimerRef, void *); static bool qt_mac_apply_settings(); friend class QMacInputMethod; friend QMAC_PASCAL OSStatus qt_window_event(EventHandlerCallRef, EventRef, void *); friend void qt_mac_update_os_settings(); friend bool qt_set_socket_handler( int, int, QObject *, bool); friend void qt_mac_destroy_widget(QWidget *); friend void qt_init(int *, char **, QApplication::Type); #endif #if defined(Q_WS_X11) private slots: void postIMEvent( QObject *receiver, QIMEvent *event ); #endif public: #ifdef QT_THREAD_SUPPORT static QMutex *qt_mutex; #endif // QT_THREAD_SUPPORT private: int app_argc; char **app_argv; bool quit_now; int quit_code; static QStyle *app_style; static int app_cspec; #ifndef QT_NO_PALETTE static QPalette *app_pal; #endif static QFont *app_font; #ifndef QT_NO_CURSOR static QCursor *app_cursor; #endif #ifndef QT_THREAD_SUPPORT static QEventLoop* eventloop; #endif static int app_tracking; static bool is_app_running; static bool is_app_closing; static bool app_exit_loop; static int loop_level; static QWidget *main_widget; static QWidget *focus_widget; static QWidget *active_window; static bool obey_desktop_settings; static int cursor_flash_time; static int mouse_double_click_time; static int wheel_scroll_lines; static int composedUnicode; // Value, meta-composed character static bool animate_ui; static bool animate_menu; static bool animate_tooltip; static bool animate_combo; static bool fade_menu; static bool fade_tooltip; static bool animate_toolbox; static bool widgetCount; // Coupled with -widgetcount switch static bool metaComposeUnicode; QValueList *translators; #ifndef QT_NO_SESSIONMANAGER QSessionManager *session_manager; QString session_id; static QString* session_key; bool is_session_restored; #endif #if defined(Q_WS_X11) #if !defined (QT_NO_STYLE) static void x11_initialize_style(); #endif static QString defaultIM; // default input method's name in this application. #endif static QSize app_strut; #ifndef QT_NO_COMPONENT static QStringList *app_libpaths; #endif static QAsciiDict *app_palettes; static QAsciiDict *app_fonts; static QWidgetList *popupWidgets; bool inPopupMode() const; void closePopup( QWidget *popup ); void openPopup( QWidget *popup ); void setActiveWindow( QWidget* act ); static bool sendSpontaneousEvent( QObject *receiver, QEvent *event ); static void removePostedEvent( QEvent * ); static void removePostedEvents( QObject *receiver, int event_type ); friend class QObject; friend class QWidget; friend class QETWidget; friend class QDialog; friend class QAccelManager; friend class QEvent; #ifdef QT_THREAD_SUPPORT friend class QThread; #endif // QT_THREAD_SUPPORT friend class QTranslator; friend class QEventLoop; friend Q_EXPORT void qt_ucm_initialize( QApplication * ); #if defined(Q_WS_WIN) friend bool qt_sendSpontaneousEvent( QObject*, QEvent* ); #endif #if defined(Q_WS_QWS) friend class QInputContext; #endif private: // Disabled copy constructor and operator= #if defined(Q_DISABLE_COPY) QApplication( const QApplication & ); QApplication &operator=( const QApplication & ); #endif private: static QEventLoop* currentEventLoop(); public: #ifdef QT_THREAD_SUPPORT static QThread* guiThread(); static void threadTerminationHandler( QThread * ); #endif static bool isGuiThread(); }; inline int QApplication::argc() const { return app_argc; } inline char **QApplication::argv() const { return app_argv; } #if defined(Q_WS_QWS) inline void QApplication::setArgs(int c, char **v) { app_argc = c; app_argv = v; } #endif #ifndef QT_NO_CURSOR inline QCursor *QApplication::overrideCursor() { return app_cursor; } #endif inline bool QApplication::hasGlobalMouseTracking() { return app_tracking > 0; } inline QWidget *QApplication::mainWidget() const { return main_widget; } inline QWidget *QApplication::focusWidget() const { return focus_widget; } inline QWidget *QApplication::activeWindow() const { return active_window; } inline QWidget *QApplication::widgetAt( const QPoint &p, bool child ) { return widgetAt( p.x(), p.y(), child ); } inline bool QApplication::inPopupMode() const { return popupWidgets != 0; } #ifndef QT_NO_SESSIONMANAGER inline bool QApplication::isSessionRestored() const { return is_session_restored; } inline QString QApplication::sessionId() const { return session_id; } inline QString QApplication::sessionKey() const { return session_key ? *session_key : QString::null; } #endif inline QSize QApplication::globalStrut() { return app_strut; } inline bool QApplication::sendEvent( QObject *receiver, QEvent *event ) { if ( event ) event->spont = FALSE; return qApp ? qApp->notify( receiver, event ) : FALSE; } inline bool QApplication::sendSpontaneousEvent( QObject *receiver, QEvent *event ) { if ( event ) event->spont = TRUE; return qApp ? qApp->notify( receiver, event ) : FALSE; } #ifdef QT_NO_TRANSLATION // Simple versions inline QString QApplication::translate( const char *, const char *sourceText, const char *, Encoding encoding ) const { #ifndef QT_NO_TEXTCODEC if ( encoding == UnicodeUTF8 ) return QString::fromUtf8( sourceText ); else #endif return QString::fromLatin1( sourceText ); } #endif inline int QApplication::horizontalAlignment( int align ) { align &= AlignHorizontal_Mask; if ( align == AlignAuto ) { if ( reverseLayout() ) align = AlignRight; else align = AlignLeft; } return align; } #endif // QAPPLICATION_H