d8/d76/qguiapplication_8h_source.html

// Copyright (C) 2016 The Qt Company Ltd.

// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only


#ifndef QGUIAPPLICATION_H

#define QGUIAPPLICATION_H


#include <QtGui/qtguiglobal.h>

#include <QtCore/qcoreapplication.h>

#include <QtGui/qwindowdefs.h>

#include <QtGui/qinputmethod.h>

#include <QtCore/qlocale.h>

#include <QtCore/qpoint.h>

#include <QtCore/qsize.h>


QT_BEGIN_NAMESPACE


class QSessionManager;

class QGuiApplicationPrivate;

class QPlatformNativeInterface;

class QPlatformIntegration;

class QPalette;

class QScreen;

class QStyleHints;


#if defined(qApp)

#undef qApp

#endif

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


#if defined(qGuiApp)

#undef qGuiApp

#endif

#define qGuiApp (static_cast<QGuiApplication *>(QCoreApplication::instance()))


class Q_GUI_EXPORT QGuiApplication : public QCoreApplication

{

    Q_OBJECT

    Q_PROPERTY(QIcon windowIcon READ windowIcon WRITE setWindowIcon)

    Q_PROPERTY(QString applicationDisplayName READ applicationDisplayName

               WRITE setApplicationDisplayName NOTIFY applicationDisplayNameChanged)

    Q_PROPERTY(QString desktopFileName READ desktopFileName WRITE setDesktopFileName)

    Q_PROPERTY(Qt::LayoutDirection layoutDirection READ layoutDirection WRITE setLayoutDirection

               NOTIFY layoutDirectionChanged)

    Q_PROPERTY(QString platformName READ platformName STORED false CONSTANT)

    Q_PROPERTY(bool quitOnLastWindowClosed  READ quitOnLastWindowClosed

               WRITE setQuitOnLastWindowClosed)

    Q_PROPERTY(QScreen *primaryScreen READ primaryScreen NOTIFY primaryScreenChanged STORED false)


public:

#ifdef Q_QDOC

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

#else

    QGuiApplication(int &argc, char **argv, int = ApplicationFlags);

#endif

    ~QGuiApplication();


    static void setApplicationDisplayName(const QString &name);

    static QString applicationDisplayName();


    Q_SLOT void setBadgeNumber(qint64 number);


    static void setDesktopFileName(const QString &name);

    static QString desktopFileName();


    static QWindowList allWindows();

    static QWindowList topLevelWindows();

    static QWindow *topLevelAt(const QPoint &pos);


    static void setWindowIcon(const QIcon &icon);

    static QIcon windowIcon();


    static QString platformName();


    static QWindow *modalWindow();


    static QWindow *focusWindow();

    static QObject *focusObject();


    static QScreen *primaryScreen();

    static QList<QScreen *> screens();

    static QScreen *screenAt(const QPoint &point);


    qreal devicePixelRatio() const;


#ifndef QT_NO_CURSOR

    static QCursor *overrideCursor();

    static void setOverrideCursor(const QCursor &);

    static void changeOverrideCursor(const QCursor &);

    static void restoreOverrideCursor();

#endif


    static QFont font();

    static void setFont(const QFont &);


#ifndef QT_NO_CLIPBOARD

    static QClipboard *clipboard();

#endif


    static QPalette palette();

    static void setPalette(const QPalette &pal);


    static Qt::KeyboardModifiers keyboardModifiers();

    static Qt::KeyboardModifiers queryKeyboardModifiers();

    static Qt::MouseButtons mouseButtons();


    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 QStyleHints *styleHints();

    static void setDesktopSettingsAware(bool on);

    static bool desktopSettingsAware();


    static QInputMethod *inputMethod();


    static QPlatformNativeInterface *platformNativeInterface();


    static QFunctionPointer platformFunction(const QByteArray &function);


    static void setQuitOnLastWindowClosed(bool quit);

    static bool quitOnLastWindowClosed();


    static Qt::ApplicationState applicationState();


    static void setHighDpiScaleFactorRoundingPolicy(Qt::HighDpiScaleFactorRoundingPolicy policy);

    static Qt::HighDpiScaleFactorRoundingPolicy highDpiScaleFactorRoundingPolicy();


    static int exec();

    bool notify(QObject *, QEvent *) override;


#ifndef QT_NO_SESSIONMANAGER

    // session management

    bool isSessionRestored() const;

    QString sessionId() const;

    QString sessionKey() const;

    bool isSavingSession() const;

#endif


    QT_DECLARE_NATIVE_INTERFACE_ACCESSOR(QGuiApplication)


    static void sync();

Q_SIGNALS:

    void fontDatabaseChanged();

    void screenAdded(QScreen *screen);

    void screenRemoved(QScreen *screen);

    void primaryScreenChanged(QScreen *screen);

    void lastWindowClosed();

    void focusObjectChanged(QObject *focusObject);

    void focusWindowChanged(QWindow *focusWindow);

    void applicationStateChanged(Qt::ApplicationState state);

    void layoutDirectionChanged(Qt::LayoutDirection direction);

#ifndef QT_NO_SESSIONMANAGER

    void commitDataRequest(QSessionManager &sessionManager);

    void saveStateRequest(QSessionManager &sessionManager);

#endif

    void applicationDisplayNameChanged();

#if QT_DEPRECATED_SINCE(6, 0)

    QT_DEPRECATED_VERSION_X_6_0("Handle QEvent::ApplicationPaletteChange instead") void paletteChanged(const QPalette &pal);

    QT_DEPRECATED_VERSION_X_6_0("Handle QEvent::ApplicationFontChange instead")  void fontChanged(const QFont &font);

#endif

protected:

    bool event(QEvent *) override;

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


    QGuiApplication(QGuiApplicationPrivate &p);


private:

    Q_DISABLE_COPY(QGuiApplication)

    Q_DECLARE_PRIVATE(QGuiApplication)


    Q_PRIVATE_SLOT(d_func(), void _q_updateFocusObject(QObject *object))


#ifndef QT_NO_GESTURES

    friend class QGestureManager;

#endif

    friend class QFontDatabasePrivate;

    friend class QPlatformIntegration;

#ifndef QT_NO_SESSIONMANAGER

    friend class QPlatformSessionManager;

#endif

};


QT_END_NAMESPACE


#include <QtGui/qguiapplication_platform.h>


#endif // QGUIAPPLICATION_H

QByteArray
\inmodule QtCore
Definition qbytearray.h:57

QClipboard
The QClipboard class provides access to the window system clipboard.
Definition qclipboard.h:20

QCoreApplication
\inmodule QtCore
Definition qcoreapplication.h:48

QCursor
The QCursor class provides a mouse cursor with an arbitrary shape.
Definition qcursor.h:45

QEvent
\inmodule QtCore
Definition qcoreevent.h:45

QFontDatabasePrivate
Definition qfontdatabase_p.h:181

QFont
\reentrant
Definition qfont.h:22

QGestureManager
Definition qgesturemanager_p.h:35

QGuiApplicationPrivate
Definition qguiapplication_p.h:59

QGuiApplication
\macro qGuiApp
Definition qguiapplication.h:37

QGuiApplication::layoutDirection
static Qt::LayoutDirection layoutDirection()

QGuiApplication::windowIcon
static QIcon windowIcon()

QGuiApplication::quitOnLastWindowClosed
static bool quitOnLastWindowClosed()

QGuiApplication::primaryScreenChanged
void primaryScreenChanged(QScreen *screen)

QGuiApplication::desktopFileName
static QString desktopFileName()

QGuiApplication::commitDataRequest
void commitDataRequest(QSessionManager &sessionManager)

QGuiApplication::applicationStateChanged
void applicationStateChanged(Qt::ApplicationState state)

QGuiApplication::focusObjectChanged
void focusObjectChanged(QObject *focusObject)
This signal is emitted when final receiver of events tied to focus is changed.

QGuiApplication::fontDatabaseChanged
void fontDatabaseChanged()
This signal is emitted when the available fonts have changed.

QGuiApplication::applicationDisplayName
static QString applicationDisplayName()

QGuiApplication::screenRemoved
void screenRemoved(QScreen *screen)
This signal is emitted whenever a screen is removed from the system.

QGuiApplication::isLeftToRight
static bool isLeftToRight()
Returns true if the application's layout direction is Qt::LeftToRight; otherwise returns false.
Definition qguiapplication.h:111

QGuiApplication::lastWindowClosed
void lastWindowClosed()
This signal is emitted from exec() when the last visible \l{Primary and Secondary Windows}{primary wi...

QGuiApplication::primaryScreen
static QScreen * primaryScreen()

QGuiApplication::applicationDisplayNameChanged
void applicationDisplayNameChanged()

QGuiApplication::focusWindowChanged
void focusWindowChanged(QWindow *focusWindow)
This signal is emitted when the focused window changes.

QGuiApplication::isRightToLeft
static bool isRightToLeft()
Returns true if the application's layout direction is Qt::RightToLeft; otherwise returns false.
Definition qguiapplication.h:110

QGuiApplication::platformName
static QString platformName()

QGuiApplication::layoutDirectionChanged
void layoutDirectionChanged(Qt::LayoutDirection direction)

QGuiApplication::saveStateRequest
void saveStateRequest(QSessionManager &sessionManager)

QGuiApplication::screenAdded
void screenAdded(QScreen *screen)
This signal is emitted whenever a new screen screen has been added to the system.

QIcon
The QIcon class provides scalable icons in different modes and states.
Definition qicon.h:20

QInputMethod
The QInputMethod class provides access to the active text input method.
Definition qinputmethod.h:19

QList< QWindow * >

QObject
\inmodule QtCore
Definition qobject.h:103

QPalette
The QPalette class contains color groups for each widget state.
Definition qpalette.h:19

QPlatformIntegration
The QPlatformIntegration class is the entry for WindowSystem specific functionality.
Definition qplatformintegration.h:74

QPlatformNativeInterface
The QPlatformNativeInterface class provides an abstraction for retrieving native resource handles.
Definition qplatformnativeinterface.h:31

QPlatformSessionManager
Definition qplatformsessionmanager.h:29

QPoint
\inmodule QtCore\reentrant
Definition qpoint.h:25

QPostEventList
Definition qthread_p.h:63

QScreen
The QScreen class is used to query screen properties. \inmodule QtGui.
Definition qscreen.h:32

QSessionManager
The QSessionManager class provides access to the session manager.
Definition qsessionmanager.h:23

QString
\macro QT_RESTRICTED_CAST_FROM_ASCII
Definition qstring.h:129

QStyleHints
The QStyleHints class contains platform specific hints and settings. \inmodule QtGui.
Definition qstylehints.h:17

QWindow
\inmodule QtGui
Definition qwindow.h:63

direction
direction
Definition doc_src_styles.cpp:42

palette
palette
Definition doc_src_styles.cpp:44

state
else opt state
[0]
Definition doc_src_styles.cpp:11

QT_BEGIN_NAMESPACE
Combined button and popup list for selecting options.
Definition qstandardpaths_haiku.cpp:21

QT_END_NAMESPACE
Definition qsharedpointer.cpp:1590

Qt
Definition qcompare.h:63

Qt::LayoutDirection
LayoutDirection
Definition qnamespace.h:1446

Qt::LeftToRight
@ LeftToRight
Definition qnamespace.h:1447

Qt::RightToLeft
@ RightToLeft
Definition qnamespace.h:1448

Qt::ApplicationState
ApplicationState
Definition qnamespace.h:262

Qt::HighDpiScaleFactorRoundingPolicy
HighDpiScaleFactorRoundingPolicy
Definition qnamespace.h:1716

void
DBusConnection const char DBusError DBusBusType DBusError return DBusConnection DBusHandleMessageFunction void DBusFreeFunction return DBusConnection return DBusConnection return const char DBusError return DBusConnection DBusMessage dbus_uint32_t return DBusConnection dbus_bool_t DBusConnection DBusAddWatchFunction DBusRemoveWatchFunction DBusWatchToggledFunction void DBusFreeFunction return DBusConnection DBusDispatchStatusFunction void DBusFreeFunction DBusTimeout return DBusTimeout return DBusWatch return DBusWatch unsigned int return DBusError const DBusError return const DBusMessage return DBusMessage return DBusMessage return DBusMessage return DBusMessage return DBusMessage return DBusMessageIter int const void return DBusMessageIter DBusMessageIter return DBusMessageIter void DBusMessageIter void int return DBusMessage DBusMessageIter return DBusMessageIter return DBusMessageIter DBusMessageIter const char const char const char const char return DBusMessage return DBusMessage const char return DBusMessage dbus_bool_t return DBusMessage dbus_uint32_t return DBusMessage void
Definition qdbus_symbols_p.h:409

QT_DECLARE_NATIVE_INTERFACE_ACCESSOR
#define QT_DECLARE_NATIVE_INTERFACE_ACCESSOR(T)
Definition qnativeinterface.h:133

name
GLuint name
Definition qopengles2ext.h:156

event
struct _cl_event * event
Definition qopenglext.h:2998

p
GLfloat GLfloat p
[1]
Definition qopenglext.h:12698

topLevelAt
static QT_BEGIN_NAMESPACE QWindow * topLevelAt(const QPoint &pos)
Definition qsimpledrag.cpp:35

screen
QScreen * screen
[1]
Definition main.cpp:29

QT_DEPRECATED_VERSION_X_6_0
#define QT_DEPRECATED_VERSION_X_6_0(text)
Definition qtdeprecationmarkers.h:127

Q_PROPERTY
#define Q_PROPERTY(...)
Definition qtmetamacros.h:56

Q_OBJECT
#define Q_OBJECT
Definition qtmetamacros.h:119

Q_PRIVATE_SLOT
#define Q_PRIVATE_SLOT(d, signature)
Definition qtmetamacros.h:46

Q_SIGNALS
#define Q_SIGNALS
Definition qtmetamacros.h:45

Q_SLOT
#define Q_SLOT
Definition qtmetamacros.h:78

qint64
long long qint64
Definition qtypes.h:60

qreal
double qreal
Definition qtypes.h:187

icon
QIcon icon
[15]
Definition src_corelib_global_qglobal.cpp:144

pos
pos
[7]
Definition src_corelib_io_qsettings.cpp:57

false
return false
Definition src_corelib_thread_qatomic.cpp:23

number
int number
[0]
Definition src_corelib_thread_qmutex.cpp:5

exec
dialog exec()

font
QFont font
Definition src_gui_dialogs_qfontdialog.cpp:6

policy
QSizePolicy policy
Definition src_gui_widgets_qsplitter.cpp:6