<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>
執行模式對話框?？刂苽鬟f給這個對話框一直到用戶關閉它，在本地事件循環完成的點并且函數返回<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>