📄 qapplication.html
字号:
<li><div class=fn>QSize <a href="#globalStrut"><b>globalStrut</b></a> ()</div></li>
<li><div class=fn>void <a href="#setLibraryPaths"><b>setLibraryPaths</b></a> ( const QStringList & paths )</div></li>
<li><div class=fn>QStringList <a href="#libraryPaths"><b>libraryPaths</b></a> ()</div></li>
<li><div class=fn>void <a href="#addLibraryPath"><b>addLibraryPath</b></a> ( const QString & path )</div></li>
<li><div class=fn>void <a href="#removeLibraryPath"><b>removeLibraryPath</b></a> ( const QString & path )</div></li>
<li><div class=fn>void <a href="#setStartDragTime"><b>setStartDragTime</b></a> ( int ms )</div></li>
<li><div class=fn>int <a href="#startDragTime"><b>startDragTime</b></a> ()</div></li>
<li><div class=fn>void <a href="#setStartDragDistance"><b>setStartDragDistance</b></a> ( int l )</div></li>
<li><div class=fn>int <a href="#startDragDistance"><b>startDragDistance</b></a> ()</div></li>
<li><div class=fn>void <a href="#setReverseLayout"><b>setReverseLayout</b></a> ( bool b )</div></li>
<li><div class=fn>bool <a href="#reverseLayout"><b>reverseLayout</b></a> ()</div></li>
<li><div class=fn>int <a href="#horizontalAlignment"><b>horizontalAlignment</b></a> ( int align )</div></li>
<li><div class=fn>bool <a href="#isEffectEnabled"><b>isEffectEnabled</b></a> ( Qt::UIEffect effect )</div></li>
<li><div class=fn>void <a href="#setEffectEnabled"><b>setEffectEnabled</b></a> ( Qt::UIEffect effect, bool enable = TRUE )</div></li>
<li><div class=fn>QWSDecoration & <a href="#qwsDecoration"><b>qwsDecoration</b></a> ()</div></li>
<li><div class=fn>void <a href="#qwsSetDecoration"><b>qwsSetDecoration</b></a> ( QWSDecoration * d )</div></li>
<li><div class=fn>WindowsVersion <a href="#winVersion"><b>winVersion</b></a> ()</div></li>
</ul>
<h2>相关函数</h2>
<ul>
<li><div class=fn>void <a href="#qAddPostRoutine"><b>qAddPostRoutine</b></a> ( QtCleanUpFunction p )</div></li>
<li><div class=fn>const char * <a href="#qVersion"><b>qVersion</b></a> ()</div></li>
<li><div class=fn>bool <a href="#qSysInfo"><b>qSysInfo</b></a> ( int * wordSize, bool * bigEndian )</div></li>
<li><div class=fn>void <a href="#qDebug"><b>qDebug</b></a> ( const char * msg, ... )</div></li>
<li><div class=fn>void <a href="#qWarning"><b>qWarning</b></a> ( const char * msg, ... )</div></li>
<li><div class=fn>void <a href="#qFatal"><b>qFatal</b></a> ( const char * msg, ... )</div></li>
<li><div class=fn>void <a href="#qSystemWarning"><b>qSystemWarning</b></a> ( const char * msg, int code )</div></li>
<li><div class=fn>void <a href="#Q_ASSERT"><b>Q_ASSERT</b></a> ( bool test )</div></li>
<li><div class=fn>void <a href="#Q_CHECK_PTR"><b>Q_CHECK_PTR</b></a> ( void * p )</div></li>
<li><div class=fn>QtMsgHandler <a href="#qInstallMsgHandler"><b>qInstallMsgHandler</b></a> ( QtMsgHandler h )</div></li>
</ul>
<hr><a name="details"></a><h2>详细描述</h2>
QApplication类管理图形用户界面应用程序的控制流和主要设置。
<p> 它包含主事件循环，在其中来自窗口系统和其它资源的所有事件被处理和调度。它也处理应用程序的初始化和结束，并且提供对话管理。它也处理绝大多数系统范围和应用程序范围的设置。
<p> 对于任何一个使用Qt的图形用户界面应用程序，都正好存在一个QApplication对象，而不论这个应用程序在同一时间内是不是有0、1、2或更多个窗口。
<p> QApplication对象是可以通过全局变量<tt>qApp</tt>访问。它的负责的主要范围有：
<ul>
<p> <li> 它使用用户的桌面设置，例如<a href="#palette">palette</a>()、<a href="#font">font</a>()和<a href="#doubleClickInterval">doubleClickInterval</a>()来初始化应用程序。如果用户改变全局桌面，例如通过一些控制面板，它会对这些属性保持跟踪。
<p> <li> 它执行事件处理，也就是说它从低下的窗口系统接收事件并且把它们分派给相关的窗口部件。通过使用<a href="#sendEvent">sendEvent</a>()和<a href="#postEvent">postEvent</a>()，你可以发送你自己的事件到窗口部件。
<p> <li> 它分析命令行参数并且根据它们设置内部状态。关于这点的详细情况请参考下面的<a href="#QApplication">构造函数文档</a>。
<p> <li> 它定义了由<a href="qstyle.html">QStyle</a>对象封装的应用程序的观感。在运行状态下，可以通过<a href="#setStyle">setStyle</a>()来改变。
<p> <li> 它指定了应用程序如何分配颜色。详细情况请参考<a href="#setColorSpec">setColorSpec</a>()。
<p> <li> 它定义了默认文本编码（请参考<a href="#setDefaultCodec">setDefaultCodec</a>()）并且提供了通过<a href="#translate">translate</a>()用户可见的<a href="i18n.html#localization">本地化</a>字符串。
<p> <li> 它提供了一些像<a href="#desktop">desktop</a>()和<a href="#clipboard">clipboard</a>()这样的魔术般的对象。
<p> <li> 它知道应用程序的窗口。你可以使用<a href="#widgetAt">widgetAt</a>()来询问在一个确定点上存在哪个窗口部件，得到一个<a href="#topLevelWidgets">topLevelWidgets</a>()（顶级窗口部件）的列表和通过<a href="#closeAllWindows">closeAllWindows</a>()来关闭所有窗口，等等。
<p> <li> 它管理应用程序的鼠标光标处理，请参考<a href="#setOverrideCursor">setOverrideCursor</a>()和<a href="#setGlobalMouseTracking">setGlobalMouseTracking</a>()。
<p> <li> 在X窗口系统上，它提供刷新和同步通讯流的函数，请参考<a href="#flushX">flushX</a>()和<a href="#syncX">syncX</a>()。
<p> <li> 它提供复杂的<a href="session.html">对话管理</a>支持。这使得当用户注销时，它可以让应用程序很好地结束，如果无法终止，撤消关闭进程并且甚至为未来的对话保留整个应用程序的状态。详细情况请参考<a href="#isSessionRestored">isSessionRestored</a>()、<a href="#sessionId">sessionId</a>()、<a href="#commitData">commitData</a>()和<a href="#saveState">saveState</a>()。
<p> </ul>
<p> <a href="simple-application.html">应用程序排演实例</a>包含了一个QApplication通常用法的典型完整的main()。
<p> 因为QApplication对象做了如此多的初始化，它<em>必须</em>在所有与用户界面相关的其它类被创建之前被创建。
<p> 因为它也处理命令行参数，在应用程序中对<tt>argv</tt>解释和修改<em>之前</em>创建它通常是一个好主意。（注意，也对于X11，<a href="#setMainWidget">setMainWidget</a>()可以根据<tt>-geometry</tt>选项来改变主窗口部件。为了保持这个功能，你必须在setMainWidget()和它的任何重载之前设置你的默认。）
<p> <center><table cellpadding="4" cellspacing="2" border="0">
<tr bgcolor="#a2c511"> <th valign="top" colspan="2" rowspan="1"> 函数分组
<tr bgcolor="#f0f0f0">
<td valign="top" width="15%">系统设置
<td valign="top" width="85%">
<a href="#desktopSettingsAware">desktopSettingsAware</a>()、<a href="#setDesktopSettingsAware">setDesktopSettingsAware</a>()、<a href="#cursorFlashTime">cursorFlashTime</a>()、<a href="#setCursorFlashTime">setCursorFlashTime</a>()、<a href="#doubleClickInterval">doubleClickInterval</a>()、<a href="#setDoubleClickInterval">setDoubleClickInterval</a>()、<a href="#wheelScrollLines">wheelScrollLines</a>()、<a href="#setWheelScrollLines">setWheelScrollLines</a>()、<a href="#palette">palette</a>()、<a href="#setPalette">setPalette</a>()、<a href="#font">font</a>()、<a href="#setFont">setFont</a>()、<a href="#fontMetrics">fontMetrics</a>()。
<tr bgcolor="#d0d0d0">
<td valign="top">事件处理
<td valign="top">
<a href="#exec">exec</a>()、<a href="#processEvents">processEvents</a>()、<a href="#enter_loop">enter_loop</a>()、<a href="#exit_loop">exit_loop</a>()、<a href="#exit">exit</a>()、<a href="#quit">quit</a>()。
<a href="#sendEvent">sendEvent</a>()、<a href="#postEvent">postEvent</a>()、<a href="#sendPostedEvents">sendPostedEvents</a>()、<a href="#removePostedEvents">removePostedEvents</a>()、<a href="#hasPendingEvents">hasPendingEvents</a>()、<a href="#notify">notify</a>()、<a href="#macEventFilter">macEventFilter</a>()、<a href="#qwsEventFilter">qwsEventFilter</a>()、<a href="#x11EventFilter">x11EventFilter</a>()、<a href="#x11ProcessEvent">x11ProcessEvent</a>()、<a href="#winEventFilter">winEventFilter</a>()。
<tr bgcolor="#f0f0f0">
<td valign="top">图形用户界面风格
<td valign="top">
<a href="#style">style</a>()、<a href="#setStyle">setStyle</a>()、<a href="#polish">polish</a>()。
<tr bgcolor="#d0d0d0">
<td valign="top">颜色使用
<td valign="top">
<a href="#colorSpec">colorSpec</a>()、<a href="#setColorSpec">setColorSpec</a>()、<a href="#qwsSetCustomColors">qwsSetCustomColors</a>()。
<tr bgcolor="#f0f0f0">
<td valign="top">文本处理
<td valign="top">
<a href="#setDefaultCodec">setDefaultCodec</a>()、<a href="#installTranslator">installTranslator</a>()、<a href="#removeTranslator">removeTranslator</a>()、<a href="#translate">translate</a>()。
<tr bgcolor="#d0d0d0">
<td valign="top">窗口部件
<td valign="top">
<a href="#mainWidget">mainWidget</a>()、<a href="#setMainWidget">setMainWidget</a>()、<a href="#allWidgets">allWidgets</a>()、<a href="#topLevelWidgets">topLevelWidgets</a>()、<a href="#desktop">desktop</a>()、<a href="#activePopupWidget">activePopupWidget</a>()、<a href="#activeModalWidget">activeModalWidget</a>()、<a href="#clipboard">clipboard</a>()、<a href="#focusWidget">focusWidget</a>()、<a href="#winFocus">winFocus</a>()、<a href="#activeWindow">activeWindow</a>()、<a href="#widgetAt">widgetAt</a>()。
<tr bgcolor="#f0f0f0">
<td valign="top">高级光标处理
<td valign="top">
<a href="#hasGlobalMouseTracking">hasGlobalMouseTracking</a>()、<a href="#setGlobalMouseTracking">setGlobalMouseTracking</a>()、<a href="#overrideCursor">overrideCursor</a>()、<a href="#setOverrideCursor">setOverrideCursor</a>()、<a href="#restoreOverrideCursor">restoreOverrideCursor</a>()。
<tr bgcolor="#d0d0d0">
<td valign="top">X窗口系统同步
<td valign="top">
<a href="#flushX">flushX</a>()、<a href="#syncX">syncX</a>()。
<tr bgcolor="#f0f0f0">
<td valign="top">对话管理
<td valign="top">
<a href="#isSessionRestored">isSessionRestored</a>()、<a href="#sessionId">sessionId</a>()、<a href="#commitData">commitData</a>()、<a href="#saveState">saveState</a>()。
<tr bgcolor="#d0d0d0">
<td valign="top">线程
<td valign="top">
<a href="#lock">lock</a>()、<a href="#unlock">unlock</a>()、<a href="#locked">locked</a>()、<a href="#tryLock">tryLock</a>()、<a href="#wakeUpGuiThread">wakeUpGuiThread</a>()。
<tr bgcolor="#f0f0f0">
<td valign="top">杂项
<td valign="top">
<a href="#closeAllWindows">closeAllWindows</a>()、<a href="#startingUp">startingUp</a>()、<a href="#closingDown">closingDown</a>()、<a href="#type">type</a>()。
</table></center>
<p> <em>非图形用户界面程序：</em>虽然Qt没有为写非图形用户界面程序而优化设计，不创建QApplication也可以使用<a href="tools.html">它的一些类</a>。如果你想在一个非图形用户界面服务器和一个图形用户界面客户端之间共享代码，这点很有用。
<p>也可以参考<a href="application.html">主窗口和相关类</a>。
<hr><h2>成员类型文档</h2>
<h3 class=fn><a name="ColorSpec-enum"></a>QApplication::ColorSpec</h3>
<p> 这个枚举变量定义了应用程序的颜色分配策略：
<ul>
<li><tt>QApplication::NormalColor</tt> - 默认的颜色分配策略
<li><tt>QApplication::CustomColor</tt> - 在X11下和NormalColor一样，在Windows下根据需要为调色板分配颜色
<li><tt>QApplication::ManyColor</tt> - 使用上千种颜色的应用程序的正确选择
</ul><p> 完整细节请参考<a href="#setColorSpec">setColorSpec</a>()。
<h3 class=fn><a name="Encoding-enum"></a>QApplication::Encoding</h3>
<p> 这个枚举变量为<a href="#translate">translate</a>()定义了字符串参数的8位编码。
<ul>
<li><tt>QApplication::DefaultCodec</tt> - <a href="#defaultCodec">defaultCodec</a>()的编码（如果没有被设置就是Latin-1）
<li><tt>QApplication::UnicodeUTF8</tt> - UTF-8
</ul><p> <p>也可以参考<a href="qobject.html#tr">QObject::tr</a>()、<a href="qobject.html#trUtf8">QObject::trUtf8</a>()和<a href="qstring.html#fromUtf8">QString::fromUtf8</a>()。
<h3 class=fn><a name="Type-enum"></a>QApplication::Type</h3>
<p> 这个枚举变量定义了QApplication的类型：
<ul>
<li><tt>QApplication::Tty</tt> - 控制台应用程序
<li><tt>QApplication::GuiClient</tt> - 图形用户界面客户端应用程序
<li><tt>QApplication::GuiServer</tt> - 图形用户界面服务器应用程序
</ul>
<hr><h2>成员函数文档</h2>
<h3 class=fn><a name="QApplication"></a>QApplication::QApplication ( int & argc, char ** argv )
</h3>
初始化窗口系统并且使用在<em>argv</em>中的<em>argc</em>个命令行参数构造一个应用程序对象。
<p> 全局指针<tt>qApp</tt>指向这个应用程序对象。应该只有一个应用程序对象被创建。
<p> 这个应用程序对象必须在任何<a href="qpaintdevice.html">绘制设备</a>（包括窗口部件、像素映射、位图等等）之前被构造。
<p> 注意<em>argc</em>和<em>argv</em>也可以被改变。Qt会移除它能够识别的命令行参数。原来的<em>argc</em>和<em>argv</em>稍后可以通过<tt>qApp->argc()</tt>和<tt>qApp->argv()</tt>来访问。<a href="#argv">argv</a>()的文档中包含如何处理命令行参数的详细描述。
<p> Qt调试选项（如果Qt被使用被定义的QT_NO_DEBUG标记进行编译，这些选项就是不可用的）：
<ul>
<li> -nograb，告诉Qt永远不要捕获鼠标或者键盘。
<li> -dograb （只有在X11下），在调试器下运行可能导致和-nograb冲突，使用-dograb来覆盖。
<li> -sync （只有在X11下），为了调试切换为同步模式。
</ul>
<p> 更详细的解释请参考<a href="debug.html">调试技术</a>。
<p> 所有的Qt程序自动支持下面这些命令行选项：
<ul>
<li> -style= <em>style</em>，设置应用程序图形用户界面风格。可能的值有<tt>motif</tt>、<tt>windows</tt>和<tt>platinum</tt>。如果你使用其它风格编译Qt或者有作为插件编译了其它风格，那么它们都可以被用作<tt>-style</tt>命令行选项。
<li> -style <em>style</em>，这个和上面的一样。
<li> -session= <em>session</em>，从以前的<a href="session.html">对话</a>中重新载入应用程序。
<li> -session <em>session</em>，这个和上面的一样。
</ul>
<p> X11版本的Qt也支持传统的X11命令行选项：
<ul>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -