diff options
Diffstat (limited to 'doc/html/qapplication-h.html')
| -rw-r--r-- | doc/html/qapplication-h.html | 576 |
1 files changed, 576 insertions, 0 deletions
diff --git a/doc/html/qapplication-h.html b/doc/html/qapplication-h.html new file mode 100644 index 0000000..ffd71a7 --- /dev/null +++ b/doc/html/qapplication-h.html @@ -0,0 +1,576 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qapplication.h:1 --> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> +<title>qapplication.h Include File</title> +<style type="text/css"><!-- +fn { margin-left: 1cm; text-indent: -1cm; } +a:link { color: #004faf; text-decoration: none } +a:visited { color: #672967; text-decoration: none } +body { background: #ffffff; color: black; } +--></style> +</head> +<body> + +<table border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr bgcolor="#E5E5E5"> +<td valign=center> + <a href="index.html"> +<font color="#004faf">Home</font></a> + | <a href="classes.html"> +<font color="#004faf">All Classes</font></a> + | <a href="mainclasses.html"> +<font color="#004faf">Main Classes</font></a> + | <a href="annotated.html"> +<font color="#004faf">Annotated</font></a> + | <a href="groups.html"> +<font color="#004faf">Grouped Classes</font></a> + | <a href="functions.html"> +<font color="#004faf">Functions</font></a> +</td> +<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>qapplication.h</h1> + +<p>This is the verbatim text of the qapplication.h include file. It is provided only for illustration; the copyright remains with Trolltech. +<hr> +<pre> +/**************************************************************************** +** $Id: qt/qapplication.h 3.3.8 edited Jan 16 10:54 $ +** +** Definition of QApplication class +** +** Created : 931107 +** +** Copyright (C) 1992-2007 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 file LICENSE.GPL 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_QWS) +class QWSDecoration; +#endif + +#ifdef QT_THREAD_SUPPORT +class QMutex; +#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 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) + static void create_xim(); + static void close_xim(); + 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 + +#ifdef QT_THREAD_SUPPORT + static QMutex *qt_mutex; +#endif // QT_THREAD_SUPPORT + + 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 + static QEventLoop* eventloop; + 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<QTranslator*> *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) && !defined (QT_NO_STYLE ) + static void x11_initialize_style(); +#endif + + static QSize app_strut; +#ifndef QT_NO_COMPONENT + static QStringList *app_libpaths; +#endif + static QAsciiDict<QPalette> *app_palettes; + static QAsciiDict<QFont> *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 * ); + + friend class QWidget; + friend class QETWidget; + friend class QDialog; + friend class QAccelManager; + friend class QEvent; + 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 +}; + +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 + +</pre> +<!-- eof --> +<p><address><hr><div align=center> +<table width=100% cellspacing=0 border=0><tr> +<td>Copyright © 2007 +<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a> +<td align=right><div align=right>Qt 3.3.8</div> +</table></div></address></body> +</html> |