QGuiApplication 类

QGuiApplication 类管理 GUI 应用程序的控制流和主要设置。更多...

头：	#include <QGuiApplication>
CMake:	find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake:	QT += gui
继承：	QCoreApplication
继承者：	QApplication

特性

applicationDisplayName : QString
desktopFileName : QString
layoutDirection : Qt::LayoutDirection
platformName : const QString

primaryScreen : QScreen* const
quitOnLastWindowClosed : bool
windowIcon : QIcon

公共函数

	QGuiApplication (int & argc , char ** argv )
virtual	~QGuiApplication ()
qreal	devicePixelRatio () const
bool	isSavingSession () const
bool	isSessionRestored () const
QNativeInterface *	nativeInterface () const
QString	sessionId () const
QString	sessionKey () const

重实现公共函数

virtual bool

notify (QObject * object , QEvent * event ) override

公共槽

(从 6.5 起) void setBadgeNumber (qint64 number )

信号

void	applicationDisplayNameChanged ()
void	applicationStateChanged (Qt::ApplicationState state )
void	commitDataRequest (QSessionManager & manager )
void	focusObjectChanged (QObject * focusObject )
void	focusWindowChanged (QWindow * focusWindow )
void	fontDatabaseChanged ()
void	lastWindowClosed ()
void	layoutDirectionChanged (Qt::LayoutDirection direction )
void	primaryScreenChanged (QScreen * screen )
void	saveStateRequest (QSessionManager & manager )
void	screenAdded (QScreen * screen )
void	screenRemoved (QScreen * screen )

静态公共成员

QWindowList	allWindows ()
QString	applicationDisplayName ()
Qt::ApplicationState	applicationState ()
void	changeOverrideCursor (const QCursor & cursor )
QClipboard *	clipboard ()
QString	desktopFileName ()
bool	desktopSettingsAware ()
int	exec ()
QObject *	focusObject ()
QWindow *	focusWindow ()
QFont	font ()
Qt::HighDpiScaleFactorRoundingPolicy	highDpiScaleFactorRoundingPolicy ()
QInputMethod *	inputMethod ()
bool	isLeftToRight ()
bool	isRightToLeft ()
Qt::KeyboardModifiers	keyboardModifiers ()
Qt::LayoutDirection	layoutDirection ()
QWindow *	modalWindow ()
Qt::MouseButtons	mouseButtons ()
QCursor *	overrideCursor ()
QPalette	palette ()
QString	platformName ()
QScreen *	primaryScreen ()
Qt::KeyboardModifiers	queryKeyboardModifiers ()
bool	quitOnLastWindowClosed ()
void	restoreOverrideCursor ()
QScreen *	screenAt (const QPoint & point )
QList<QScreen *>	screens ()
void	setApplicationDisplayName (const QString & name )
void	setDesktopFileName (const QString & name )
void	setDesktopSettingsAware (bool on )
void	setFont (const QFont & font )
void	setHighDpiScaleFactorRoundingPolicy (Qt::HighDpiScaleFactorRoundingPolicy policy )
void	setLayoutDirection (Qt::LayoutDirection direction )
void	setOverrideCursor (const QCursor & cursor )
void	setPalette (const QPalette & pal )
void	setQuitOnLastWindowClosed (bool quit )
void	setWindowIcon (const QIcon & icon )
QStyleHints *	styleHints ()
void	sync ()
QWindow *	topLevelAt (const QPoint & pos )
QWindowList	topLevelWindows ()
QIcon	windowIcon ()

重实现保护函数

virtual bool

event (QEvent * e ) override

宏

qGuiApp

详细描述

QGuiApplication 包含主事件循环，处理和分派来自窗口系统和其它源的所有事件。它还处理应用程序的初始化和定稿，及提供会话管理。此外，QGuiApplication 处理大多数系统范围和应用程序范围的设置。

对于使用 QT 的任何 GUI 应用程序，准确存在 one QGuiApplication 对象，无论应用程序在任何给定时间是否拥有 0 个、1 个、2 个或更多个窗口。对于非 GUI Qt 应用程序，使用 QCoreApplication 代替，因为它不依赖 Qt GUI 模块。对于 QWidget 基 Qt 应用程序，使用 QApplication 代替，因为由它提供的某些功能需要创建 QWidget 实例。

QGuiApplication 对象可访问透过实例 () 函数，返回指针相当于全局 qApp 指针。

QApplication 主要负责的领域：

采用用户桌面设置初始化应用程序，譬如 palette (), font () 和 styleHints ()。它对这些特性保持追踪，若用户全局更改桌面，例如透过某种控制面板。
它履行事件处理，意味着它接收来自底层窗口系统的事件并将它们分派给相关 Widget。可以将自己的事件发送给窗口通过使用 sendEvent () 和 postEvent ().
它剖析常见命令行自变量从而设置其内部状态。见构造函数文档编制下文了解更多细节。
它提供用户可见的字符串本地化凭借 translate ().
它提供某些魔法对象，像 clipboard ().
它知道有关应用程序的窗口。可以询问在某个位置是哪个窗口使用 topLevelAt ()，获取列表为 topLevelWindows ()，等。
它管理应用程序的鼠标光标处理，见 setOverrideCursor ()
它提供支持完备会话管理。这使应用程序能够在用户注销时优雅终止，若不可能终止，可以取消关闭进程，甚至保留整个应用程序的状态对于将来的会话。见 isSessionRestored (), sessionId () 和 commitDataRequest () 和 saveStateRequest () 了解细节。

由于 QGuiApplication 对象会做如此多的初始化，它 must 被创建，在创建用户界面相关的任何其它对象之前。QGuiApplication 还处理常见命令行自变量。因此，创建它通常是一个好主意 before 任何解释或修改对于 argv 的履行在应用程序本身。

函数组
系统设置	desktopSettingsAware (), setDesktopSettingsAware (), styleHints (), palette (), setPalette (), font (), setFont ().
事件处理	exec (), processEvents (), exit (), quit (). sendEvent (), postEvent (), sendPostedEvents (), removePostedEvents (), notify ().
Windows	allWindows (), topLevelWindows (), focusWindow (), clipboard (), topLevelAt ().
高级光标处理	overrideCursor (), setOverrideCursor (), restoreOverrideCursor ().
会话管理	isSessionRestored (), sessionId (), commitDataRequest (), saveStateRequest ().
杂项	startingUp (), closingDown ().

另请参阅 QCoreApplication , QAbstractEventDispatcher ，和 QEventLoop .

特性文档编制

applicationDisplayName : QString

此特性保持此应用程序的用户可见名称

此名称将展示给用户，例如在窗口标题中。可以翻译它，若有必要。

若未设置，应用程序显示名称默认为应用程序名称。

访问函数：

QString	applicationDisplayName ()
void	setApplicationDisplayName (const QString & name )

通知程序信号：

void	applicationDisplayNameChanged ()

另请参阅 applicationName .

desktopFileName : QString

此特性保持用于此应用程序桌面条目的基本名称

这是文件名，没有完整路径，也没有桌面条目 (根据 freedesktop 桌面条目规范表示此应用程序) 结尾的 .desktop 扩展名。

此特性给出什么桌面条目表示应用程序的精密指示，且窗口系统需要在不求助于不精密试探的情况下检索这种信息。

可以获得最新版本的 freedesktop 桌面条目规范 here .

访问函数：

QString	desktopFileName ()
void	setDesktopFileName (const QString & name )

layoutDirection : Qt::LayoutDirection

此特性保持用于此应用程序的默认布局方向

系统启动时，或在将方向明确设为 Qt::LayoutDirectionAuto ，默认布局方向从属应用程序的语言。

通知信号在 Qt 5.4 引入。

访问函数：

Qt::LayoutDirection	layoutDirection ()
void	setLayoutDirection (Qt::LayoutDirection direction )

通知程序信号：

void	layoutDirectionChanged (Qt::LayoutDirection direction )

另请参阅 QWidget::layoutDirection , isLeftToRight ()，和 isRightToLeft ().

`[read-only]` platformName : const QString

此特性保持底层平台插件的名称。

QPA 平台插件位于 qtbase\src\plugins\platforms 。当撰写本文时，支持下列平台插件名称：

android
cocoa 是 macOS 平台插件。
directfb
eglfs 是无需实际窗口系统 (像 X11 或 Wayland) 在 EGL 和 OpenGL ES 2.0 之上运行 Qt5 应用程序的平台插件。更多信息，见 EGLFS .
ios (还用于 tvOS)
linuxfb 直接写入帧缓冲。更多信息，见 LinuxFB .
minimal 为想要编写自己平台插件的开发者提供范例。不管怎样，可以使用插件在没有 GUI 的环境下运行 GUI 应用程序，譬如：服务器。
minimalegl 是范例插件。
offscreen
qnx
windows
wayland 是 Wayland 显示服务器协议平台插件，用于某些 Linux 桌面和嵌入式系统。
xcb 是 X11 窗口系统插件，用于某些桌面 Linux 平台。

注意： 调用此函数不采用 QGuiApplication 将返回默认平台名，若可用。默认平台名不受影响通过 -platform 命令行选项，或 QT_QPA_PLATFORM 环境变量。

关于嵌入式 Linux 设备平台插件的更多信息，见 Qt for Embedded Linux .

访问函数：

QString

platformName ()

`[read-only]` primaryScreen : QScreen * const

此特性保持应用程序的首要 (或默认) 屏幕。

这将是最初展示 QWindows 的屏幕，除非另有指定。

primaryScreenChanged 信号在 Qt 5.6 引入。

访问函数：

QScreen *

primaryScreen ()

通知程序信号：

void	primaryScreenChanged (QScreen * screen )

另请参阅 screens ().

quitOnLastWindowClosed : bool

此特性保持应用程序是否隐式离开，当关闭最后一个窗口时。

默认为 true .

若此特性为 true ，应用程序将试图离开，当最后一个可见首要窗口 (即：没有瞬时父级的顶层窗口) 关闭。

注意，试图离开可能不一定导致应用程序正离开，例如，若仍有活动的 QEventLoopLocker 实例，或 QEvent::Quit 事件被忽略。

访问函数：

bool	quitOnLastWindowClosed ()
void	setQuitOnLastWindowClosed (bool quit )

另请参阅 quit () 和 QWindow::close ().

windowIcon : QIcon

此特性保持默认窗口图标

访问函数：

QIcon	windowIcon ()
void	setWindowIcon (const QIcon & icon )

另请参阅 QWindow::setIcon () 和设置应用程序图标 .

成员函数文档编制

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

初始化窗口系统并构造应用程序对象采用 argc 命令行自变量在 argv .

警告： 数据引用通过 argc and argv 必须在 QGuiApplication 对象的整个生命周期内保持有效。此外， argc 必须大于 0 且 argv 必须包含至少一条有效字符串。

全局 qApp 指针引用此应用程序对象。只应创建一个应用程序对象。

此应用程序对象必须被构造先于任何描绘设备 (包括像素图、位图等)。

注意： argc and argv 可能改变当 Qt 移除它识别的命令行自变量时。

支持的命令行选项

所有 Qt 程序自动支持允许修改 Qt 与窗口系统交互方式的一组命令行选项。首选凭借环境变量访问某些选项，若应用程序可以发起 GUI 子进程或其它应用程序 (环境变量将由子级进程继承)。当有疑问时，使用环境变量。

目前支持下列选项：

-platform platformName [:options] ，指定 Qt Platform Abstraction (QPA) 插件。

覆写 QT_QPA_PLATFORM 环境变量。

-platformpluginpath path ，指定平台插件的路径。

覆写 QT_QPA_PLATFORM_PLUGIN_PATH 环境变量。

-platformtheme platformTheme ，指定平台主题。

覆写 QT_QPA_PLATFORMTHEME 环境变量。

-plugin plugin ，指定要加载的额外插件。自变量可能出现多次。

串联插件按 QT_QPA_GENERIC_PLUGINS 环境变量。

-qmljsdebugger= ，采用指定端口激活 QML/JS 调试器。值格式必须为 port:1234 [,block] ，其中 block 可选且将使应用程序等待，直到调试器连接到它为止。
-qwindowgeometry geometry ，使用 X11 句法为主窗口指定窗口几何体。例如： -qwindowgeometry 100x100+50+50
-qwindowicon ，设置默认窗口图标
-qwindowtitle ，设置第一窗口标题
-reverse ，将应用程序的布局方向设为 Qt::RightToLeft 。此选项旨在辅助调试且不应用于生产。默认值自动检测自用户区域设置 (另请参阅 QLocale::textDirection ()).
-session session ，还原应用程序从早期 session .

下列标准命令行选项可用于 X11：

-display hostname:screen_number ，切换 X11 显示。

覆写 DISPLAY 环境变量。

-geometry geometry ，如同 -qwindowgeometry .

特定平台自变量

可以指定特定平台自变量为 -platform 选项。将它们放在平台插件名称后，随后冒号紧跟逗号分隔列表。例如， -platform windows:dialogs=xp,fontengine=freetype .

以下参数可用于 -platform windows :

altgr ，检测键 AltGr 发现在某些键盘是作为 Qt::GroupSwitchModifier (从 Qt 5.12 起)。
darkmode=[0|1|2] 控制 Qt 如何响应激活的 用于应用程序的暗黑模式 引入在 Windows 10 1903(从 Qt 5.15 起)。

0 值禁用暗黑模式支持。

1 值导致 Qt 将窗口边框切换为黑色，当 用于应用程序的暗黑模式 被激活且未使用高对比度主题。这旨在为应用程序实现自己的主题化。

此外，2 值导致 Windows Vista 风格被取消激活，并切换到使用简化调色板的暗黑模式 Windows 风格。目前这是实验性的，直到引入正确适配暗黑模式的新风格为止。

从 Qt 6.5 起，默认值为 2；要禁用暗黑模式支持，把值设为 0 (或 1)。

dialogs=[xp|none] , xp 使用 XP 风格本机对话框和 none 禁用它们。
fontengine=freetype 使用 FreeType 字体引擎。
fontengine=directwrite ，使用实验性 DirectWrite 字体数据库，并默认使用 DirectWrite 字体引擎 (否则，其只用于某些字体类型或字体特性)。这影响字体选定，且目标是提供与其它平台更一致的字体命名，但不支持所有字体格式 (譬如：Postscript Type-1 或微软 FNT 字体)。
menus=[native|none] ，控制本机菜单的使用。

本机菜单的实现是使用 Win32 API 且更简单相比 QMenu 基菜单，例如，它们允许放置 Widget 或改变像字体特性等，但不提供悬停信号。它们主要旨在用于 Qt Quick。默认情况下，将使用它们，若应用程序不是实例化的 QApplication 或对于 Qt Quick Controls 2 应用程序 (从 Qt 5.10 起)。
nocolorfonts 关闭 DirectWrite Color 字体 (从 Qt 5.8 起)。
nodirectwrite 关闭 DirectWrite 字体 (从 Qt 5.8 起)。
nomousefromtouch 忽略由 OS (操作系统) 从触摸事件合成的鼠标事件。
nowmpointer 从指针输入消息处理切换到传统鼠标处理 (从 Qt 5.12 起)。
reverse 激活从右到左模式 (实验性)。Windows 标题栏将以从右到左区域设置方式相应展示 (从 Qt 5.13 起)。
tabletabsoluterange=<value> 设置用于 WinTab 平板的鼠标模式检测值 (传统，从 Qt 5.3 起)。

下列参数可用于 -platform cocoa (在 macOS)：

fontengine=freetype 使用 FreeType 字体引擎。

关于可用于嵌入式 Linux 平台的特定平台自变量的更多信息，见 Qt for Embedded Linux .

另请参阅 arguments () 和 QGuiApplication::platformName .

`[virtual noexcept]` QGuiApplication:: ~QGuiApplication ()

销毁应用程序。

`[static]` QWindowList QGuiApplication:: allWindows ()

返回应用程序所有窗口的列表。

列表为空，若没有窗口。

另请参阅 topLevelWindows ().

`[static]` Qt::ApplicationState QGuiApplication:: applicationState ()

返回应用程序的当前状态。

可以对应用程序状态改变做出反应，以履行譬如：停止/再继续 CPU 密集型任务、释放/加载资源、或保存/还原应用程序数据。

`[signal]` void QGuiApplication:: applicationStateChanged ( Qt::ApplicationState state )

此信号发射当 state 对于应用程序改变。

另请参阅 applicationState ().

`[static]` void QGuiApplication:: changeOverrideCursor (const QCursor & cursor )

将当前活动应用程序的覆盖光标改为 cursor .

此函数不起作用若 setOverrideCursor () 未被调用。

另请参阅 setOverrideCursor (), overrideCursor (), restoreOverrideCursor ()，和 QWidget::setCursor ().

`[static]` QClipboard *QGuiApplication:: clipboard ()

返回与剪贴板交互的对象。

`[signal]` void QGuiApplication:: commitDataRequest ( QSessionManager & manager )

此信号处理会话管理。它被发射当 QSessionManager 想要应用程序提交其所有数据。

通常这意味着保存所有打开文件，在从用户获得权限后。此外，可能想要提供由用户可以取消关闭的手段。

不应退出应用程序，在此信号内。相反，会话管理器可以 (或不可以) 之后这样做，从属上下文。

警告： 在此信号内，不可能进行用户交互， unless 要求 manager 明确权限。见 QSessionManager::allowsInteraction () 和 QSessionManager::allowsErrorInteraction () 了解细节和范例用法。

注意： 应使用 Qt::DirectConnection 当连接到此信号时。

另请参阅 isSessionRestored (), sessionId (), saveStateRequest ()，和会话管理 .

`[static]` bool QGuiApplication:: desktopSettingsAware ()

返回 true 若 Qt 被设为使用系统标准颜色、字体、等；否则返回 false 。默认为 true .

另请参阅 setDesktopSettingsAware ().

qreal QGuiApplication:: devicePixelRatio () const

返回系统中找到的最高屏幕设备像素比率。这是物理像素和设备无关像素之间的比率。

才使用此函数，当不知道目标窗口是哪个时。若知道目标窗口，使用 QWindow::devicePixelRatio () 代替。

另请参阅 QWindow::devicePixelRatio ().

`[override virtual protected]` bool QGuiApplication:: event ( QEvent * e )

重实现： QCoreApplication::event (QEvent *e).

`[static]` int QGuiApplication:: exec ()

进入主事件循环并等待，直到 exit () 被调用，然后将设置值返回给 exit () (为 0 若 exit () 被调用凭借 quit ()).

有必要调用此函数以启动事件处理。主事件循环从窗口系统接收事件，并将其分派给应用程序 Widget。

一般来说，不可以进行用户交互在调用 exec() 之前。

要使应用程序履行空闲处理 (如：执行特殊函数每当没有待处理事件时)，使用 QTimer 采用 0 超时。更高级空闲处理方案可以达成使用 processEvents ().

推荐把清理代码连接到 aboutToQuit () 信号，而不是将它放入应用程序的 main() 函数。这是因为，在某些平台， QApplication::exec () 调用可能不返回。

另请参阅 quitOnLastWindowClosed , quit (), exit (), processEvents ()，和 QCoreApplication::exec ().

`[static]` QObject *QGuiApplication:: focusObject ()

返回 QObject 在当前活动窗口中，将是聚焦相关事件的最终接收者，譬如：键事件。

`[signal]` void QGuiApplication:: focusObjectChanged ( QObject * focusObject )

此信号被发射当聚焦相关事件的最终接收者改变时。 focusObject 是新接收者。

另请参阅 focusObject ().

`[static]` QWindow *QGuiApplication:: focusWindow ()

返回 QWindow 接收聚焦相关事件，譬如：键事件。

另请参阅 QWindow::requestActivate ().

`[signal]` void QGuiApplication:: focusWindowChanged ( QWindow * focusWindow )

此信号被发射，当聚焦窗口改变时。 focusWindow 是新聚焦窗口。

另请参阅 focusWindow ().

`[static]` QFont QGuiApplication:: font ()

返回应用程序的默认字体。

另请参阅 setFont ().

`[signal]` void QGuiApplication:: fontDatabaseChanged ()

此信号被发射，当可用字体有改变。

这会发生，当添加 (或移除) 应用程序字体时，或当系统字体改变时。

另请参阅 QFontDatabase::addApplicationFont (), QFontDatabase::addApplicationFontFromData (), QFontDatabase::removeAllApplicationFonts ()，和 QFontDatabase::removeApplicationFont ().

`[static]` Qt::HighDpiScaleFactorRoundingPolicy QGuiApplication:: highDpiScaleFactorRoundingPolicy ()

返回高 DPI (每英寸点数) 比例缩放因子舍入策略。

另请参阅 setHighDpiScaleFactorRoundingPolicy ().

`[static]` QInputMethod *QGuiApplication:: inputMethod ()

返回输入法。

输入法返回虚拟键盘状态和位置的有关特性。它还提供当前聚焦输入元素位置的有关信息。

另请参阅 QInputMethod .

`[static]` bool QGuiApplication:: isLeftToRight ()

返回 true 若应用程序的布局方向是 Qt::LeftToRight ；否则返回 false .

另请参阅 layoutDirection () 和 isRightToLeft ().

`[static]` bool QGuiApplication:: isRightToLeft ()

返回 true 若应用程序的布局方向是 Qt::RightToLeft ；否则返回 false .

另请参阅 layoutDirection () 和 isLeftToRight ().

bool QGuiApplication:: isSavingSession () const

返回 true 若应用程序目前正在保存 session ；否则返回 false .

这为 true 当 commitDataRequest () 和 saveStateRequest () 被发射，且之后通过会话管理关闭窗口时也如此。

另请参阅 sessionId (), commitDataRequest ()，和 saveStateRequest ().

bool QGuiApplication:: isSessionRestored () const

返回 true 若应用程序已还原从较早 session ；否则返回 false .

另请参阅 sessionId (), commitDataRequest ()，和 saveStateRequest ().

`[static]` Qt::KeyboardModifiers QGuiApplication:: keyboardModifiers ()

返回键盘修饰符键的当前状态。当前状态同步更新，当事件队列清空将自发改变键盘状态的事件时 ( QEvent::KeyPress and QEvent::KeyRelease 事件)。

应注意，这可能不反映调用时在输入设备上保持的实际键，但反映上述事件之一最后报告的修饰符。若没有保持键， Qt::NoModifier 被返回。

另请参阅 mouseButtons () 和 queryKeyboardModifiers ().

`[signal]` void QGuiApplication:: lastWindowClosed ()

此信号被发射从 exec () 当最后一个可见首要窗口 (即：没有瞬时父级的顶层窗口) 关闭。

默认情况下， QGuiApplication 离开在此信号发射后。可以关闭此特征通过设置 quitOnLastWindowClosed to false .

另请参阅 QWindow::close (), QWindow::isTopLevel ()，和 QWindow::transientParent ().

`[static]` QWindow *QGuiApplication:: modalWindow ()

返回最近展示的模态窗口。若没有可见的模态窗口，此函数返回 0。

模态窗口这种窗口有它自己的 modality 特性被设为 Qt::WindowModal or Qt::ApplicationModal 。必须关闭模态窗口，在用户可以继续使用程序其它部分前。

模态窗口被组织在堆栈中。此函数返回在堆栈顶部的模态窗口。

另请参阅 Qt::WindowModality and QWindow::setModality ().

`[static]` Qt::MouseButtons QGuiApplication:: mouseButtons ()

返回鼠标按钮的当前状态。同步更新当前状态，在事件队列事件清空将自发改变鼠标状态时 ( QEvent::MouseButtonPress and QEvent::MouseButtonRelease 事件)。

应该注意的是，这可能不反映调用时输入设备保持的实际按钮，而是某一上述事件最后报告的鼠标按钮。若未按住鼠标按钮 Qt::NoButton 被返回。

另请参阅 keyboardModifiers ().

template <typename QNativeInterface> QNativeInterface *QGuiApplication:: nativeInterface () const

返回用于应用程序的给定类型本机接口。

此函数提供对平台特定功能的访问为 QGuiApplication ，作为定义在 QNativeInterface 名称空间：

QNativeInterface::QWaylandApplication	Wayland 应用程序的本机接口
QNativeInterface::QX11Application	到 X11 应用程序的本机接口

若请求接口不可用 nullptr 被返回。

`[override virtual]` bool QGuiApplication:: notify ( QObject * object , QEvent * event )

重实现： QCoreApplication::notify (QObject *receiver, QEvent *event).

`[static]` QCursor *QGuiApplication:: overrideCursor ()

返回活动应用程序的覆盖光标。

此函数返回 nullptr 若应用程序光标未定义 (即：内部光标堆栈为空)。

另请参阅 setOverrideCursor () 和 restoreOverrideCursor ().

`[static]` QPalette QGuiApplication:: palette ()

返回当前应用程序调色板。

尚未明确设置的角色，将反射系统平台主题。

另请参阅 setPalette ().

`[static]` Qt::KeyboardModifiers QGuiApplication:: queryKeyboardModifiers ()

查询并返回键盘修饰符键的状态。不像 keyboardModifiers 此方法返回调用方法时保持在输入设备上的实际键。

它不依赖必须由此进程接收的键按下事件，譬如：这使得当移动窗口时校验修饰符成为可能。注意：在大多数情况下，应使用 keyboardModifiers ()，其更快更准确，因为它包含的修饰符状态 (如同接收当前处理事件时状态)。

另请参阅 keyboardModifiers ().

`[static]` void QGuiApplication:: restoreOverrideCursor ()

撤消最后 setOverrideCursor ().

若 setOverrideCursor () 被调用 2 次，调用 restoreOverrideCursor() 将激活第 1 次光标设置。第 2 次调用此函数将还原 Widget 的原始光标。

另请参阅 setOverrideCursor () 和 overrideCursor ().

`[signal]` void QGuiApplication:: saveStateRequest ( QSessionManager & manager )

此信号处理会话管理。它被援引当会话管理器想要应用程序为未来会话保留其状态。

例如，文本编辑器将创建临时文件 (包括当前编辑缓冲内容、光标位置及当前编辑会话的其它方面)。

You should never exit the application within this signal. Instead, the session manager may or may not do this afterwards, depending on the context. Furthermore, most session managers will very likely request a saved state immediately after the application has been started. This permits the session manager to learn about the application's restart policy.

警告： 在此信号内，不可能进行用户交互， unless 要求 manager 明确权限。见 QSessionManager::allowsInteraction () 和 QSessionManager::allowsErrorInteraction () 了解细节。

注意： 应使用 Qt::DirectConnection 当连接到此信号时。

另请参阅 isSessionRestored (), sessionId (), commitDataRequest ()，和会话管理 .

`[signal]` void QGuiApplication:: screenAdded ( QScreen * screen )

此信号被发射每当新屏幕 screen 已添加到系统。

另请参阅 screens (), primaryScreen ，和 screenRemoved ().

`[static]` QScreen QGuiApplication:: screenAt (const QPoint & point* )

返回屏幕，位于 point ，或 nullptr 若在任何屏幕之外。

The point is in relation to the virtualGeometry() of each set of virtual siblings. If the point maps to more than one set of virtual siblings the first match is returned. If you wish to search only the virtual desktop siblings of a known screen (for example siblings of the screen of your application window QWidget::windowHandle()->screen() )，使用 QScreen::virtualSiblingAt ().

`[signal]` void QGuiApplication:: screenRemoved ( QScreen * screen )

此信号发射每当 screen 被移除从系统。它提供了管理屏幕窗口的机会，在 Qt 回退以将它们移到首要屏幕之前。

另请参阅 screens (), screenAdded (), QObject::destroyed ()，和 QWindow::setScreen ().

`[static]` QList < QScreen *> QGuiApplication:: screens ()

返回应用程序连接到的窗口系统，所关联的所有屏幕的列表。

QString QGuiApplication:: sessionId () const

返回当前会话的标识符。

若应用程序已从早期会话还原，此标识符与先前会话标识符相同。会话标识符保证，对于不同应用程序和同一应用程序的不同实例是唯一的。

另请参阅 isSessionRestored (), sessionKey (), commitDataRequest ()，和 saveStateRequest ().

QString QGuiApplication:: sessionKey () const

返回会话键，在当前 session .

若应用程序已从早期会话还原，此键与先前会话结束时的键相同。

会话键将改变，每次保存会话时。若关闭过程被取消，再次关闭时将使用另一会话键。

另请参阅 isSessionRestored (), sessionId (), commitDataRequest ()，和 saveStateRequest ().

`[slot, since 6.5]` void QGuiApplication:: setBadgeNumber ( qint64 number )

将应用程序徽章设为 number .

用于向用户提供有关未读 (或类似) 消息数的反馈。

徽章覆盖在 macOS 的 Dock (停放) 图标上、iOS 的首页屏幕图标上、或 Windows 和 Linux 的任务栏上。

若 number 超出平台支持范围，number 会被钳制到支持范围。若 number 未拟合在徽章内，number 可能是 ... 视觉省略。

把编号设为 0 将清零徽章。

该函数在 Qt 6.5 引入。

另请参阅 applicationName .

`[static]` void QGuiApplication:: setDesktopSettingsAware ( bool on )

将 Qt 是否应使用系统标准颜色、字体等设为 on 。默认情况下，这是 true .

此函数必须先被调用才创建 QGuiApplication 对象，像这样：

int main(int argc, char *argv[])
{
    QApplication::setDesktopSettingsAware(false);
    QApplication app(argc, argv);
    // ...
    return app.exec();
}

另请参阅 desktopSettingsAware ().

`[static]` void QGuiApplication:: setFont (const QFont & font )

将应用程序默认字体改为 font .

另请参阅 font ().

`[static]` void QGuiApplication:: setHighDpiScaleFactorRoundingPolicy ( Qt::HighDpiScaleFactorRoundingPolicy policy )

设置用于应用程序的高 DPI (每英寸点数) 比例缩放因子舍入策略。 policy decides how non-integer scale factors (such as Windows 150%) are handled.

The two principal options are whether fractional scale factors should be rounded to an integer or not. Keeping the scale factor as-is will make the user interface size match the OS setting exactly, but may cause painting errors, for example with the Windows style.

If rounding is wanted, then which type of rounding should be decided next. Mathematically correct rounding is supported but may not give the best visual results: Consider if you want to render 1.5x as 1x ("small UI") or as 2x ("large UI"). See the Qt::HighDpiScaleFactorRoundingPolicy enum for a complete list of all options.

必须调用此函数，在创建应用程序对象之前。 QGuiApplication::highDpiScaleFactorRoundingPolicy () 访问器将反射环境，若设置。

默认值为 Qt::HighDpiScaleFactorRoundingPolicy::PassThrough .

另请参阅 highDpiScaleFactorRoundingPolicy ().

`[static]` void QGuiApplication:: setOverrideCursor (const QCursor & cursor )

将应用程序覆盖光标设为 cursor .

应用程序覆盖光标旨在向用户展示应用程序处于特殊状态，例如：在可能需要一些时间的操作期间。

此光标将显示在所有应用程序的 Widget 中，直到 restoreOverrideCursor () 或另一 setOverrideCursor() 被调用。

应用程序光标存储在内部堆栈中。setOverrideCursor() 将光标压入堆栈，而 restoreOverrideCursor () 将活动光标从堆栈中弹出。 changeOverrideCursor () 更改当前活动应用程序的覆盖光标。

每个 setOverrideCursor() 之后最终必须跟随相应 restoreOverrideCursor ()，否则，将从不清空堆栈。

范例：

QGuiApplication::setOverrideCursor(QCursor(Qt::WaitCursor));
calculateHugeMandelbrot();              // lunch time...
QGuiApplication::restoreOverrideCursor();

另请参阅 overrideCursor (), restoreOverrideCursor (), changeOverrideCursor ()，和 QWidget::setCursor ().

`[static]` void QGuiApplication:: setPalette (const QPalette & pal )

将应用程序调色板更改为 pal .

来自此调色板的颜色角色与系统平台主题组合，形成应用程序的最终调色板。

另请参阅 palette ().

`[static]` QStyleHints *QGuiApplication:: styleHints ()

返回应用程序的样式提示。

样式提示封装了一组从属平台特性，譬如：双击间隔、全宽选定、等。

提示可以用于与底层平台更紧密集成。

另请参阅 QStyleHints .

`[static]` void QGuiApplication:: sync ()

可以用于将 Qt 状态和窗口系统状态同步的函数。

此函数将首先清空 Qt 事件通过调用 QCoreApplication::processEvents ()，然后平台插件同步窗口系统，最后交付 Qt 事件通过另一调用 QCoreApplication::processEvents ();

此函数很耗时，且不鼓励使用它。

`[static]` QWindow QGuiApplication:: topLevelAt (const QPoint & pos* )

返回顶层窗口在给定位置 pos ，若有的话。

`[static]` QWindowList QGuiApplication:: topLevelWindows ()

返回应用程序顶层窗口列表。

另请参阅 allWindows ().

宏文档编制

qGuiApp

引用唯一应用程序对象的全局指针。才可有效使用当对象是 QGuiApplication .

另请参阅 QCoreApplication::instance () 和 qApp .

QGuiApplication 类

特性

公共函数

重实现公共函数

公共槽

信号

静态公共成员

重实现保护函数

宏

详细描述

特性文档编制

applicationDisplayName : QString

desktopFileName : QString

layoutDirection : Qt::LayoutDirection

[read-only] platformName : const QString

[read-only] primaryScreen : QScreen * const

quitOnLastWindowClosed : bool

windowIcon : QIcon

成员函数文档编制

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

支持的命令行选项

特定平台自变量

[virtual noexcept] QGuiApplication:: ~QGuiApplication ()

[static] QWindowList QGuiApplication:: allWindows ()

[static] Qt::ApplicationState QGuiApplication:: applicationState ()

[signal] void QGuiApplication:: applicationStateChanged ( Qt::ApplicationState state )

[static] void QGuiApplication:: changeOverrideCursor (const QCursor & cursor )

[static] QClipboard *QGuiApplication:: clipboard ()

[signal] void QGuiApplication:: commitDataRequest ( QSessionManager & manager )

[static] bool QGuiApplication:: desktopSettingsAware ()

qreal QGuiApplication:: devicePixelRatio () const

[override virtual protected] bool QGuiApplication:: event ( QEvent * e )

[static] int QGuiApplication:: exec ()

[static] QObject *QGuiApplication:: focusObject ()

[signal] void QGuiApplication:: focusObjectChanged ( QObject * focusObject )

[static] QWindow *QGuiApplication:: focusWindow ()

[signal] void QGuiApplication:: focusWindowChanged ( QWindow * focusWindow )

[static] QFont QGuiApplication:: font ()

[signal] void QGuiApplication:: fontDatabaseChanged ()

[static] Qt::HighDpiScaleFactorRoundingPolicy QGuiApplication:: highDpiScaleFactorRoundingPolicy ()

[static] QInputMethod *QGuiApplication:: inputMethod ()

[static] bool QGuiApplication:: isLeftToRight ()

[static] bool QGuiApplication:: isRightToLeft ()

bool QGuiApplication:: isSavingSession () const

bool QGuiApplication:: isSessionRestored () const

[static] Qt::KeyboardModifiers QGuiApplication:: keyboardModifiers ()

[signal] void QGuiApplication:: lastWindowClosed ()

[static] QWindow *QGuiApplication:: modalWindow ()

[static] Qt::MouseButtons QGuiApplication:: mouseButtons ()

template <typename QNativeInterface> QNativeInterface *QGuiApplication:: nativeInterface () const

[override virtual] bool QGuiApplication:: notify ( QObject * object , QEvent * event )

[static] QCursor *QGuiApplication:: overrideCursor ()

[static] QPalette QGuiApplication:: palette ()

[static] Qt::KeyboardModifiers QGuiApplication:: queryKeyboardModifiers ()

[static] void QGuiApplication:: restoreOverrideCursor ()

[signal] void QGuiApplication:: saveStateRequest ( QSessionManager & manager )

[signal] void QGuiApplication:: screenAdded ( QScreen * screen )

[static] QScreen *QGuiApplication:: screenAt (const QPoint & point )

[signal] void QGuiApplication:: screenRemoved ( QScreen * screen )

[static] QList < QScreen *> QGuiApplication:: screens ()

QString QGuiApplication:: sessionId () const

QString QGuiApplication:: sessionKey () const

[slot, since 6.5] void QGuiApplication:: setBadgeNumber ( qint64 number )

[static] void QGuiApplication:: setDesktopSettingsAware ( bool on )

[static] void QGuiApplication:: setFont (const QFont & font )

[static] void QGuiApplication:: setHighDpiScaleFactorRoundingPolicy ( Qt::HighDpiScaleFactorRoundingPolicy policy )

[static] void QGuiApplication:: setOverrideCursor (const QCursor & cursor )

[static] void QGuiApplication:: setPalette (const QPalette & pal )

[static] QStyleHints *QGuiApplication:: styleHints ()

[static] void QGuiApplication:: sync ()

[static] QWindow *QGuiApplication:: topLevelAt (const QPoint & pos )

[static] QWindowList QGuiApplication:: topLevelWindows ()

宏文档编制

qGuiApp

内容

`[read-only]` platformName : const QString

`[read-only]` primaryScreen : QScreen * const

`[virtual noexcept]` QGuiApplication:: ~QGuiApplication ()

`[static]` QWindowList QGuiApplication:: allWindows ()

`[static]` Qt::ApplicationState QGuiApplication:: applicationState ()

`[signal]` void QGuiApplication:: applicationStateChanged ( Qt::ApplicationState state )

`[static]` void QGuiApplication:: changeOverrideCursor (const QCursor & cursor )

`[static]` QClipboard *QGuiApplication:: clipboard ()

`[signal]` void QGuiApplication:: commitDataRequest ( QSessionManager & manager )

`[static]` bool QGuiApplication:: desktopSettingsAware ()

`[override virtual protected]` bool QGuiApplication:: event ( QEvent * e )

`[static]` int QGuiApplication:: exec ()

`[static]` QObject *QGuiApplication:: focusObject ()

`[signal]` void QGuiApplication:: focusObjectChanged ( QObject * focusObject )

`[static]` QWindow *QGuiApplication:: focusWindow ()

`[signal]` void QGuiApplication:: focusWindowChanged ( QWindow * focusWindow )

`[static]` QFont QGuiApplication:: font ()

`[signal]` void QGuiApplication:: fontDatabaseChanged ()

`[static]` Qt::HighDpiScaleFactorRoundingPolicy QGuiApplication:: highDpiScaleFactorRoundingPolicy ()

`[static]` QInputMethod *QGuiApplication:: inputMethod ()

`[static]` bool QGuiApplication:: isLeftToRight ()

`[static]` bool QGuiApplication:: isRightToLeft ()

`[static]` Qt::KeyboardModifiers QGuiApplication:: keyboardModifiers ()

`[signal]` void QGuiApplication:: lastWindowClosed ()

`[static]` QWindow *QGuiApplication:: modalWindow ()

`[static]` Qt::MouseButtons QGuiApplication:: mouseButtons ()

`[override virtual]` bool QGuiApplication:: notify ( QObject * object , QEvent * event )

`[static]` QCursor *QGuiApplication:: overrideCursor ()

`[static]` QPalette QGuiApplication:: palette ()

`[static]` Qt::KeyboardModifiers QGuiApplication:: queryKeyboardModifiers ()

`[static]` void QGuiApplication:: restoreOverrideCursor ()

`[signal]` void QGuiApplication:: saveStateRequest ( QSessionManager & manager )

`[signal]` void QGuiApplication:: screenAdded ( QScreen * screen )

`[static]` QScreen QGuiApplication:: screenAt (const QPoint & point* )

`[signal]` void QGuiApplication:: screenRemoved ( QScreen * screen )

`[static]` QList < QScreen *> QGuiApplication:: screens ()

`[slot, since 6.5]` void QGuiApplication:: setBadgeNumber ( qint64 number )

`[static]` void QGuiApplication:: setDesktopSettingsAware ( bool on )

`[static]` void QGuiApplication:: setFont (const QFont & font )

`[static]` void QGuiApplication:: setHighDpiScaleFactorRoundingPolicy ( Qt::HighDpiScaleFactorRoundingPolicy policy )

`[static]` void QGuiApplication:: setOverrideCursor (const QCursor & cursor )

`[static]` void QGuiApplication:: setPalette (const QPalette & pal )

`[static]` QStyleHints *QGuiApplication:: styleHints ()

`[static]` void QGuiApplication:: sync ()

`[static]` QWindow QGuiApplication:: topLevelAt (const QPoint & pos* )

`[static]` QWindowList QGuiApplication:: topLevelWindows ()