qapplication.html

这是qt3的帮助文档的中文版

</h3>
使铃发声，使用默认音量和声音。

<h3 class=fn><a href="qclipboard.html">QClipboard</a>&nbsp;* <a name="clipboard"></a>QApplication::clipboard ()<tt> [静态]</tt>
</h3>
返回应用程序全局剪贴板的指针。
<p>实例：<a href="showimg-example.html#x1246">showimg/showimg.cpp</a>。

<h3 class=fn>void <a name="closeAllWindows"></a>QApplication::closeAllWindows ()<tt> [槽]</tt>
</h3>
关闭所有顶级窗口。
<p> 这个函数对于有很多顶级窗口部件的应用程序相当有用。例如，它可以被和文件菜单中的“Quit”条目连接，正如下面的代码实例：
<p> <pre>
    // “Quit”菜单条目应该试图关闭所有窗口
    <a href="qpopupmenu.html">QPopupMenu</a>* file = new <a href="qpopupmenu.html">QPopupMenu</a>( this );
    file-&gt;<a href="qmenudata.html#insertItem">insertItem</a>( "&amp;Quit", qApp, SLOT(<a href="#closeAllWindows">closeAllWindows</a>()), CTRL+Key_Q );

    // 当最后一个窗口被关闭，应用程序应该退出
    <a href="qobject.html#connect">connect</a>( qApp, SIGNAL( <a href="#lastWindowClosed">lastWindowClosed</a>() ), qApp, SLOT( <a href="#quit">quit</a>() ) );
  </pre>
 
<p> 窗口是被按随机顺序关闭的，直到一个窗口不接受关闭事件。
<p> <p>也可以参考<a href="qwidget.html#close">QWidget::close</a>()、<a href="qwidget.html#closeEvent">QWidget::closeEvent</a>()、<a href="#lastWindowClosed">lastWindowClosed</a>()、<a href="#quit">quit</a>()、<a href="#topLevelWidgets">topLevelWidgets</a>()和<a href="qwidget.html#isTopLevel-prop">QWidget::isTopLevel</a>。
<p>实例：<a href="qaction-application-example.html#x1063">action/application.cpp</a>、<a href="simple-application-example.html#x1507">application/application.cpp</a>、<a href="helpviewer-example.html#x981">helpviewer/helpwindow.cpp</a>、<a href="mdi-example.html#x2004">mdi/application.cpp</a>和<a href="qwerty-example.html#x356">qwerty/qwerty.cpp</a>。

<h3 class=fn>bool <a name="closingDown"></a>QApplication::closingDown ()<tt> [静态]</tt>
</h3>
如果应用程序对象正在被销毁，返回真，否则返回假。
<p> <p>也可以参考<a href="#startingUp">startingUp</a>()。

<h3 class=fn>int <a name="colorSpec"></a>QApplication::colorSpec ()<tt> [静态]</tt>
</h3>
返回颜色规格。
<p>也可以参考<a href="#setColorSpec">QApplication::setColorSpec</a>()。
<p>实例：<a href="showimg-example.html#x1247">showimg/showimg.cpp</a>。

<h3 class=fn>void <a name="commitData"></a>QApplication::commitData ( <a href="qsessionmanager.html">QSessionManager</a>&nbsp;&amp;&nbsp;sm )<tt> [虚]</tt>
</h3>
<p> 这个函数处理对话管理。当<a href="qsessionmanager.html">QSessionManager</a>想让应用程序提交它的所有数据时，它被调用。
<p> 通常这意味着在得到用户的许可之后保存所有打开的文件。此外你可能想提供让用户可以撤销这个关闭的选择。
<p> 注意你不应该在这个函数中退出这个应用程序。相反，对话管理器在这之后也许会，也许不会这样做，依赖上下文。
<p> <b>警告：</b>在这个函数中，不能有任何用户交互，<em>除非</em>你请求对话管理器<em>sm</em>明确的允许。详细情况和使用实例请参考<a href="qsessionmanager.html#allowsInteraction">QSessionManager::allowsInteraction</a>()和<a href="qsessionmanager.html#allowsErrorInteraction">QSessionManager::allowsErrorInteraction</a>()。
<p> 默认实现请求交互并且发送一个关闭事件给所有可视的顶级窗口部件。如果任何一个事件被拒绝，那么关闭被撤销。
<p> <p>也可以参考<a href="#isSessionRestored">isSessionRestored</a>()、<a href="#sessionId">sessionId</a>()和<a href="#saveState">saveState</a>()。

<h3 class=fn>int <a name="cursorFlashTime"></a>QApplication::cursorFlashTime ()<tt> [静态]</tt>
</h3>
返回文本关标闪烁（闪亮）的时间，以毫秒为单位。闪烁时间是显示、转化和恢复脱字符显示所使用的时间。
<p> 在X11上的默认值是1000毫秒。在Windows上，使用控制面板的值。
<p> 窗口部件不应该存储这个值，因为它可能在任何时候被用户改变全局桌面设置而改变。
<p> <p>也可以参考<a href="#setCursorFlashTime">setCursorFlashTime</a>()。

<h3 class=fn><a href="qtextcodec.html">QTextCodec</a>&nbsp;* <a name="defaultCodec"></a>QApplication::defaultCodec () const
</h3>
返回默认的编解码器（请参考<a href="#setDefaultCodec">setDefaultCodec</a>()）。默认返回0（没有编解码器）。

<h3 class=fn><a href="qdesktopwidget.html">QDesktopWidget</a>&nbsp;* <a name="desktop"></a>QApplication::desktop ()<tt> [静态]</tt>
</h3>
返回桌面窗口部件（也调用根窗口）。
<p> 桌面窗口部件对于获得屏幕大小很有用。在桌面上绘制也是可能的。我们建议不要假设可以在桌面上绘制，因为它不能在所有的操作系统上工作。
<p> <pre>
    <a href="qdesktopwidget.html">QDesktopWidget</a> *d = QApplication::<a href="#desktop">desktop</a>();
    int w = d-&gt;<a href="qwidget.html#width">width</a>();     // 返回桌面宽度
    int h = d-&gt;<a href="qwidget.html#height">height</a>();    // 返回桌面高度
  </pre>
<p>实例：<a href="canvas-example.html#x2734">canvas/main.cpp</a>、<a href="desktop-example.html#x1759">desktop/desktop.cpp</a>、<a href="helpviewer-example.html#x1040">helpviewer/main.cpp</a>、<a href="i18n-example.html#x1917">i18n/main.cpp</a>、<a href="qmag-example.html#x1618">qmag/qmag.cpp</a>、<a href="qwerty-example.html#x412">qwerty/main.cpp</a>和<a href="scribble-example.html#x974">scribble/main.cpp</a>。

<h3 class=fn>bool <a name="desktopSettingsAware"></a>QApplication::desktopSettingsAware ()<tt> [静态]</tt>
</h3>
返回由<a href="#setDesktopSettingsAware">setDesktopSettingsAware</a>()设置的值，默认返回真。
<p> <p>也可以参考<a href="#setDesktopSettingsAware">setDesktopSettingsAware</a>()。

<h3 class=fn>int <a name="doubleClickInterval"></a>QApplication::doubleClickInterval ()<tt> [静态]</tt>
</h3>
返回双击的最大持续时间。
<p> 在X11上默认值为400毫秒。在Windows上，使用控制面板的值。
<p> <p>也可以参考<a href="#setDoubleClickInterval">setDoubleClickInterval</a>()。

<h3 class=fn>int <a name="enter_loop"></a>QApplication::enter_loop ()
</h3>
这个函数进入主事件循环（递归地）。除非你真的直到你正在做什么，否则请不要调用它。
<p> <p>也可以参考<a href="#exit_loop">exit_loop</a>()和<a href="#loopLevel">loopLevel</a>()。

<h3 class=fn>int <a name="exec"></a>QApplication::exec ()
</h3>
进入主事件循环并且等待，直到<a href="#exit">exit</a>()被调用或者主窗口部件被销毁，并且返回值被设置为exit()（如果通过<a href="#quit">quit</a>()，exit()被调用，为0）。
<p> 需要调用这个函数来开始事件处理。主事件循环从窗口系统中接收事件并且把它们分派给应用程序窗口部件。
<p> 通常来说，在调用<a href="#exec">exec</a>()之前，没有用户交互可以发生。作为一个特例，像<a href="qmessagebox.html">QMessageBox</a>这样的模式对话框可以在调用exec()之前使用，因为模式对话框调用exec()来开始本地事件循环。
<p> 为了使你的应用程序执行空闲处理，例如，只要没有未处理地事件，执行一个特殊的函数，使用<a href="qtimer.html">QTimer</a>，0超时。更高级的空闲处理方案可以使用<a href="#processEvents">processEvents</a>()来完成。
<p> <p>也可以参考<a href="#quit">quit</a>()、<a href="#exit">exit</a>()、<a href="#processEvents">processEvents</a>()和<a href="#setMainWidget">setMainWidget</a>()。
<p>实例：<a href="biff-example.html#x1948">biff/main.cpp</a>、<a href="tutorial2-04.html#x2462">chart/main.cpp</a>、<a href="simple-qfont-demo-walkthrough.html#x2133">fonts/simple-qfont-demo/simple-qfont-demo.cpp</a>、<a href="qdialog.html#x2102">life/main.cpp</a>、<a href="tutorial1-01.html#x2270">t1/main.cpp</a>、<a href="tutorial1-04.html#x2290">t4/main.cpp</a>和<a href="outliner-example.html#x1907">xml/outliner/main.cpp</a>。

<h3 class=fn>void <a name="exit"></a>QApplication::exit ( int&nbsp;retcode = 0 )<tt> [静态]</tt>
</h3>
告诉应用程序退出，伴随一个返回代码。
<p> 在这个函数被调用之后，应用程序离开主事件循环并且从<a href="#exec">exec</a>()调用之后返回。exec()函数返回<em>retcode</em>。
<p> 根据习惯，为0的<em>retcode</em>意味着成功，并且任何非零的值意味着错误。
<p> 注意与同名的C库函数不同，这个函数<em>返回</em>到调用者——它的事件处理结束。
<p> <p>也可以参考<a href="#quit">quit</a>()和<a href="#exec">exec</a>()。
<p>实例：<a href="canvas-chart-example.html#x2592">chart/chartform.cpp</a>和<a href="picture-example.html#x74">picture/picture.cpp</a>。

<h3 class=fn>void <a name="exit_loop"></a>QApplication::exit_loop ()
</h3>
这个函数从到主事件循环的递归调用中退出。不要调用它，除非你是一个专家。
<p> <p>也可以参考<a href="#enter_loop">enter_loop</a>()和<a href="#loopLevel">loopLevel</a>()。

<h3 class=fn>void <a name="flush"></a>QApplication::flush ()<tt> [静态]</tt>
</h3>
刷新窗口系统指定事件队列。
<p> 如果在异步的窗口系统，例如X11，或者双缓存的窗口系统，例如Mac OS X的不返回事件循环的循环中正在做图形变化，并且你想立即显现这些变化（比如，Splash Screen），请调用这个函数。
<p> <p>也可以参考<a href="#flushX">flushX</a>()、<a href="#sendPostedEvents">sendPostedEvents</a>()和<a href="qpainter.html#flush">QPainter::flush</a>()。

<h3 class=fn>void <a name="flushX"></a>QApplication::flushX ()<tt> [静态]</tt>
</h3>
在X11实现中刷新X事件队列。这通常会立即返回。在其它平台上不会做任何事。
<p> <p>也可以参考<a href="#syncX">syncX</a>()。
<p>实例：<a href="xform-example.html#x1416">xform/xform.cpp</a>。

<h3 class=fn><a href="qwidget.html">QWidget</a>&nbsp;* <a name="focusWidget"></a>QApplication::focusWidget () const
</h3>
<p> 返回拥有键盘输入焦点的应用程序窗口部件，或者在这个应用程序中没有窗口部件拥有焦点，返回0。
<p> <p>也可以参考<a href="qwidget.html#setFocus">QWidget::setFocus</a>()、<a href="qwidget.html#focus-prop">QWidget::focus</a>和<a href="#activeWindow">activeWindow</a>()。

<h3 class=fn><a href="qfont.html">QFont</a> <a name="font"></a>QApplication::font ( const&nbsp;<a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;w = 0 )<tt> [静态]</tt>
</h3>
返回窗口部件<em>w</em>的默认字体，或者如果<em>w</em>为0，返回默认应用程序字体。
<p> <p>也可以参考<a href="#setFont">setFont</a>()、<a href="#fontMetrics">fontMetrics</a>()和<a href="qwidget.html#font-prop">QWidget::font</a>。
<p>实例：<a href="qfd-example.html#x1965">qfd/fontdisplayer.cpp</a>、<a href="themes-example.html#x224">themes/metal.cpp</a>和<a href="themes-example.html#x281">themes/themes.cpp</a>。

<h3 class=fn><a href="qfontmetrics.html">QFontMetrics</a> <a name="fontMetrics"></a>QApplication::fontMetrics ()<tt> [静态]</tt>
</h3>
返回应用程序字体的显示（屏幕）字体规格。
<p> <p>也可以参考<a href="#font">font</a>()、<a href="#setFont">setFont</a>()、<a href="qwidget.html#fontMetrics">QWidget::fontMetrics</a>()和<a href="qpainter.html#fontMetrics">QPainter::fontMetrics</a>()。

<h3 class=fn><a href="qsize.html">QSize</a> <a name="globalStrut"></a>QApplication::globalStrut ()<tt> [静态]</tt>
</h3>
<p> 返回应用程序的全局strut。
<p> strut是任何用户可以交互的图形交互界面元素的最小维数的大小对象。例如，没有按钮应该被重新定义大小小于全局strut大小。
<p> <p>也可以参考<a href="#setGlobalStrut">setGlobalStrut</a>()。

<h3 class=fn>void <a name="guiThreadAwake"></a>QApplication::guiThreadAwake ()<tt> [信号]</tt>
</h3>
<p> 当图形用户界面线程要处理一个事件循环的周期，这个信号被发射。
<p> <p>也可以参考<a href="#wakeUpGuiThread">wakeUpGuiThread</a>()。

<h3 class=fn>bool <a name="hasGlobalMouseTracking"></a>QApplication::hasGlobalMouseTracking ()<tt> [静态]</tt>
</h3>
<p> 如果全局鼠标跟踪生效，返回真，否则返回假。
<p> <p>也可以参考<a href="#setGlobalMouseTracking">setGlobalMouseTracking</a>()。

<h3 class=fn>bool <a name="hasPendingEvents"></a>QApplication::hasPendingEvents ()