qdialog.html

QT参考文档

    <a name="x2104"></a>    life-&gt;<a href="qwidget.html#setCaption">setCaption</a>("Qt Example - Life");
    <a name="x2105"></a>    life-&gt;<a href="qwidget.html#show">show</a>();
</pre><pre>    <a name="x2102"></a>    return a.<a href="qapplication.html#exec">exec</a>();
    }
</pre>
<p> 半模式对话框的实例请参考<a href="qprogressdialog.html">QProgressDialog</a>文档。
<p> <p>请参考<a href="qtabdialog.html">QTabDialog</a>、<a href="qwidget.html">QWidget</a>、<a href="qprogressdialog.html">QProgressDialog</a>、<a href="guibooks.html#fowler">GUI Design Handbook: Dialogs, Standard</a>、<a href="abstractwidgets.html">抽象窗口部件类</a>和<a href="dialogs.html">对话框类</a>。

<hr><h2>成员类型文档</h2>
<h3 class=fn><a name="DialogCode-enum"></a>QDialog::DialogCode</h3> 
<p> 模式对话框返回的值。
<ul>
<li><tt>QDialog::Accepted</tt>
<li><tt>QDialog::Rejected</tt>
</ul><p> 

<hr><h2>成员函数文档</h2>
<h3 class=fn><a name="QDialog"></a>QDialog::QDialog ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;parent = 0, const&nbsp;char&nbsp;*&nbsp;name = 0, bool&nbsp;modal = FALSE, WFlags&nbsp;f = 0 )
</h3>
构造一个父对象为<em>parent</em>、名称为<em>name</em>的对话框。
<p> 如果<em>modal</em>为假（默认），这个对话框是非模式的并且应该使用<a href="#show">show</a>()来被显示。如果<em>modal</em>为真，这个对话框使用<a href="#exec">exec</a>()来被显示，则它是模式的，也就是说会阻塞这个应用程序中其它窗口的输入。如果<em>modal</em>为真并且使用show()来被显示，则它是半模式的。
<p> 窗口部件<em>f</em>将被传递给<a href="qwidget.html">QWidget</a>的构造函数。
<p> 如果，例如，我们不想要对话框的标题栏中“这是什么”按钮，在<em>f</em>中传递WStyle_Customize | WStyle_NormalBorder | WStyle_Title | WStyle_SysMenu。
<p> 我们建议你传递一个非空的父对象。
<p> <p>请参考<a href="qwidget.html#setWFlags">QWidget::setWFlags</a>()和<a href="qt.html#WidgetFlags-enum">Qt::WidgetFlags</a>。

<h3 class=fn><a name="~QDialog"></a>QDialog::~QDialog ()
</h3>
销毁这个对话框，删除它所有的子对象。

<h3 class=fn>void <a name="accept"></a>QDialog::accept ()<tt> [虚 保护 槽]</tt>
</h3>
隐藏模式对话框并且设置结果代码为<a href="#DialogCode-enum">Accepted</a>。
<p>请参考<a href="#reject">reject</a>()和<a href="#done">done</a>()。
<p>实例：<a href="tutorial2-08.html#x2509">chart/setdataform.cpp</a>。

<h3 class=fn>void <a name="done"></a>QDialog::done ( int&nbsp;r )<tt> [虚 保护 槽]</tt>
</h3> 
隐藏模式对话框并且设置结果代码为<em>r</em>。这将使用本地事件循环来完成，并且<a href="#exec">exec</a>()返回<em>r</em>。
<p> 如果对话框使用<a href="qt.html#WidgetFlags-enum">WDestructiveClose</a>来被设置，<a href="#done">done</a>()也会销毁这个对话框。如果对话框是应用程序的主窗口部件，那么应用程序终止。
<p> <p>请参考<a href="#accept">accept</a>()、<a href="#reject">reject</a>()、<a href="qapplication.html#mainWidget">QApplication::mainWidget</a>()和<a href="qapplication.html#quit">QApplication::quit</a>()。

<h3 class=fn>int <a name="exec"></a>QDialog::exec ()<tt> [槽]</tt>
</h3>
执行模式对话框。控制传递给这个对话框一直到用户关闭它，在本地事件循环完成的点并且函数返回<a href="#DialogCode-enum">DialogCode</a>结果。在用户关闭这个对话框之前，不能和同一应用程序中的其它窗口交互。对于非模式或半模式对话框请使用<a href="#show">show</a>()。
<p> <p>请参考<a href="#show">show</a>()和<a href="#result">result</a>()。
<p>实例：<a href="canvas-chart-example.html#x2594">chart/chartform.cpp</a>、<a href="i18n-example.html#x1925">i18n/main.cpp</a>、<a href="qdialog.html#x2096">network/networkprotocol/view.cpp</a>、a href="qdir-example.html#x1805">qdir/qdir.cpp</a>、<a href="showimg-example.html#x1254">showimg/showimg.cpp</a>和<a href="wizard-example.html#x16">wizard/main.cpp</a>。

<h3 class=fn><a href="qwidget.html">QWidget</a>&nbsp;* <a name="extension"></a>QDialog::extension () const
</h3>
返回对话框的扩展或者如果没有扩展被定义返回0。
<p> <p>请参考<a href="#setExtension">setExtension</a>()。

<h3 class=fn>bool <a name="isSizeGripEnabled"></a>QDialog::isSizeGripEnabled () const
</h3>
<p>如果大小控制生效，返回真，否则返回假。详细情况请参考<a href="qdialog.html#sizeGripEnabled-prop">“sizeGripEnabled”</a>属性。

<h3 class=fn><a href="qt.html#Orientation-enum">Orientation</a> <a name="orientation"></a>QDialog::orientation () const
</h3>
返回对话框的扩展方向。
<p> <p>请参考<a href="#setOrientation">setOrientation</a>()。

<h3 class=fn>void <a name="reject"></a>QDialog::reject ()<tt> [虚 保护 槽]</tt>
</h3>
隐藏模式对话框并且设置结果代码为<a href="#DialogCode-enum">Rejected</a>。
<p>请参考<a href="#accept">accept</a>()和<a href="#done">done</a>()。

<h3 class=fn>int <a name="result"></a>QDialog::result () const
</h3>
<p> 返回模式对话框的结果代码，<a href="#DialogCode-enum">Accepted</a>或<a href="#DialogCode-enum">Rejected</a>。
<p> 如果对话框使用<a href="qt.html#WidgetFlags-enum">WDestructiveClose</a>标记构造，不要调用这个函数。（无论如何，<a href="#exec">exec</a>()返回结果代码。）

<h3 class=fn>void <a name="setExtension"></a>QDialog::setExtension ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;extension )
</h3>
设置窗口部件<em>extension</em>为对话框的扩展，删除任何以前的扩展。对话框拥有扩展的所有权。注意如果传递0，则任何存在的扩展都将被删除。
<p> 只有当对话框被隐藏时，这个函数才能被调用。
<p> <p>请参考<a href="#showExtension">showExtension</a>()、<a href="#setOrientation">setOrientation</a>()和<a href="#extension">extension</a>()。

<h3 class=fn>void <a name="setOrientation"></a>QDialog::setOrientation ( <a href="qt.html#Orientation-enum">Orientation</a>&nbsp;orientation )
</h3>
如果<em>orientation</em>是<a href="qt.html#Orientation-enum">Horizontal</a>，扩展将会显示在对话框主区域的右面。如果<em>orientation</em>是<a href="qt.html#Orientation-enum">Vertical</a>，扩展将会显示在对话框主区域的下面。
<p> <p>请参考<a href="#orientation">orientation</a>()和<a href="#setExtension">setExtension</a>()。

<h3 class=fn>void <a name="setResult"></a>QDialog::setResult ( int&nbsp;i )<tt> [保护]</tt>
</h3>
<p> 设置模式对话框的结果代码为<em>i</em>。

<h3 class=fn>void <a name="setSizeGripEnabled"></a>QDialog::setSizeGripEnabled ( bool )
</h3>
<p>设置大小控制是否生效。详细情况请参考<a href="qdialog.html#sizeGripEnabled-prop">“sizeGripEnabled”</a>属性。

<h3 class=fn>void <a name="show"></a>QDialog::show ()<tt> [虚]</tt>
</h3>
显示非模式或半模式对话框。控制立即返回到调用代码中。
<p> 对话框没有一个本地事件循环，所以你必须定时地调用<a href="qapplication.html#processEvents">QApplication::processEvents</a>()来使对话框能够得到处理它的事件的机会。
<p> 如果在构造函数中，模式标记被设置为真，对话框将为<a href="#semimodal">半模式</a>。
<p> <b>警告：</b>
<p> 在Qt 2.x中，在一个模式对话框中调用<a href="#show">show</a>()进入一个本地事件循环并且像<a href="#exec">exec</a>()一样工作，但是不返回exec()所返回的结果代码。Trolltech已经一直警告这样做是不被建议的。
<p> <p>请参考<a href="#exec">exec</a>()。
<p>实例：<a href="movies-example.html#x445">movies/main.cpp</a>、<a href="showimg-example.html#x1255">showimg/showimg.cpp</a>和<a href="sql.html#x2219">sql/overview/form1/main.cpp</a>。
<p>从<a href="qwidget.html#show">QWidget</a>中重新实现的。

<h3 class=fn>void <a name="showExtension"></a>QDialog::showExtension ( bool&nbsp;showIt )<tt> [保护 槽]</tt>
</h3>
如果<em>showIt</em>为真，对话框的扩展被显示，否则扩展被隐藏。
<p> 这个槽通常被连接到<a href="qpushbutton.html">QPushButton</a>的<a href="qbutton.html#toggled">QButton::toggled</a>()信号上。
<p> 如果对话框不是可视的，或者没有扩展，则什么都不会发生。
<p> <p>请参考<a href="#show">show</a>()、<a href="#setExtension">setExtension</a>()和<a href="#setOrientation">setOrientation</a>()。

<hr><h2>属性文档</h2>
<h3 class=fn>bool <a name="sizeGripEnabled-prop"></a>sizeGripEnabled</h3>
<p>这个属性保存的是大小控制是否生效。
<p>当这个属性生效时，<a href="qsizegrip.html">QSizeGrip</a>被放置到对话框的右下角。默认情况下，大小控制失效。
<p>通过<a href="#setSizeGripEnabled">setSizeGripEnabled</a>()设置属性值并且通过<a href="#isSizeGripEnabled">isSizeGripEnabled</a>()来获得属性值。

<!-- eof -->
<hr><p>
这个文件是<a href="index.html">Qt工具包</a>一部分。
版权所有 &copy; 1995-2002
<a href="http://www.trolltech.com/">Trolltech</a>。保留所有权利。
<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright &copy; 2002 
<a href="http://www.trolltech.com">Trolltech</a>
<td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a>
<td><a href="zh_CN.html">译者:Cavendish</a>
<td align=right><div align=right>Qt 3.0.5版</div>
</table></div></address></body>
</html>