qprogressdialog.html

QT参考文档

<p> <em>cancelButtonText</em>是显示在取消按钮上的文本，或者如果没有取消按钮被显示就为0。
<p> <em>totalSteps</em>是这个进度对话框显示进度的操作的总步数。例如，如果这个操作检测50个文件，这个值就应该为50。在检测第一个文件之前，调用<a href="#setProgress">setProgress</a>(0)。每一个问卷被处理的时候，调用setProgress(1)、setProgress(2)等等，在检测完最后一个文件之后调用setProgress(50)。
<p> <em>name</em>、<em>modal</em>和窗口部件标记<em>f</em>被传递给<a href="qdialog.html#QDialog">QDialog::QDialog</a>()的构造函数。如果<em>modal</em>为假（默认），你必须有一个正在进行的事件循环来重新绘制这个对话框的变化。如果<em>modal</em>为真，这个对话框确保当需要的时候事件会被处理。
<p> <em>creator</em>参数是用来做为这个对话框的父对象的窗口部件。如果<em>creator</em>不是一个顶级窗口部件，传递给<a href="qdialog.html">QDialog</a>构造函数的这个参数将为0。
<p> <p>也可以参考<a href="#labelText-prop">labelText</a>、<a href="#setLabel">setLabel</a>()、<a href="#setCancelButtonText">setCancelButtonText</a>()、<a href="#setCancelButton">setCancelButton</a>()和<a href="#totalSteps-prop">totalSteps</a>。

<h3 class=fn><a name="~QProgressDialog"></a>QProgressDialog::~QProgressDialog ()
</h3>
销毁这个进度对话框。

<h3 class=fn>bool <a name="autoClose"></a>QProgressDialog::autoClose () const
</h3>
<p>如果通过<a href="#reset">reset</a>()对话框是隐藏的，返回真，否则返回假。详细情况请参考<a href="qprogressdialog.html#autoClose-prop">“autoClose”</a>属性。

<h3 class=fn>bool <a name="autoReset"></a>QProgressDialog::autoReset () const
</h3>
<p>如果一旦<a href="#progress">progress</a>()等于<a href="#totalSteps">totalSteps</a>()，进度对话框调用<a href="#reset">reset</a>()，返回真，否则返回假。详细情况请参考<a href="qprogressdialog.html#autoReset-prop">“autoReset”</a>属性。

<h3 class=fn>void <a name="cancel"></a>QProgressDialog::cancel ()<tt> [槽]</tt>
</h3>
重置这个进度对话框。知道这个进度对话框被重置了，<a href="#wasCancelled">wasCancelled</a>()变为真。这个进度对话框变隐藏了。

<h3 class=fn>void <a name="cancelled"></a>QProgressDialog::cancelled ()<tt> [信号]</tt>
</h3>
<p> 当取消按钮被点击时，这个信号被发射。它默认被连接到<a href="#cancel">cancel</a>()槽。
<p> <p>也可以参考<a href="#wasCancelled-prop">wasCancelled</a>。
<p>实例：<a href="progress-example.html#x50">progress/progress.cpp</a>。

<h3 class=fn>void <a name="forceShow"></a>QProgressDialog::forceShow ()<tt> [保护 槽]</tt>
</h3>
如果在算法已经开始并且minimumDuration毫秒数已经过去之后它还被隐藏，显示这个对话框。
<p> <p>也可以参考<a href="#minimumDuration-prop">minimumDuration</a>。

<h3 class=fn><a href="qstring.html">QString</a> <a name="labelText"></a>QProgressDialog::labelText () const
</h3>
<p>返回标签的文本。详细情况请参考<a href="qprogressdialog.html#labelText-prop">“labelText”</a>属性。

<h3 class=fn>int <a name="minimumDuration"></a>QProgressDialog::minimumDuration () const
</h3>
<p>返回进度就应该在对话框打开之前运行的时间。详细情况请参考<a href="qprogressdialog.html#minimumDuration-prop">“minimumDuration”</a>属性。

<h3 class=fn>int <a name="progress"></a>QProgressDialog::progress () const
</h3>
<p>返回进度当前的进度。详细情况请参考<a href="qprogressdialog.html#progress-prop">“progress”</a>属性。

<h3 class=fn>void <a name="reset"></a>QProgressDialog::reset ()<tt> [槽]</tt>
</h3>
重置这个进度对话框。如果<a href="#autoClose">autoClose</a>()为真，进度对话框变为隐藏。
<p> <p>也可以参考<a href="#autoClose-prop">autoClose</a>和<a href="#autoReset-prop">autoReset</a>。

<h3 class=fn>void <a name="setAutoClose"></a>QProgressDialog::setAutoClose ( bool&nbsp;b )
</h3>
<p>设置通过<a href="#reset">reset</a>()对话框是否隐藏为<em>b</em>。详细情况请参考<a href="qprogressdialog.html#autoClose-prop">“autoClose”</a>属性。

<h3 class=fn>void <a name="setAutoReset"></a>QProgressDialog::setAutoReset ( bool&nbsp;b )
</h3>
<p>设置一旦<a href="#progress">progress</a>()等于<a href="#totalSteps">totalSteps</a>()，进度对话框是否调用<a href="#reset">reset</a>()为<em>b</em>。详细情况请参考<a href="qprogressdialog.html#autoReset-prop">“autoReset”</a>属性。

<h3 class=fn>void <a name="setBar"></a>QProgressDialog::setBar ( <a href="qprogressbar.html">QProgressBar</a>&nbsp;*&nbsp;bar )
</h3>
设置进度条窗口部件为<em>bar</em>。进度对话框会重新定义大小来适合它。进度对话框会得到进度条<em>bar</em>，<em>bar</em>当需要的时候会被删除，所以不要在使用在栈中分配的进度条。

<h3 class=fn>void <a name="setCancelButton"></a>QProgressDialog::setCancelButton ( <a href="qpushbutton.html">QPushButton</a>&nbsp;*&nbsp;cancelButton )
</h3>
设置取消按钮为推动按钮<em>cancelButton</em>。进度对话框会得到这个按钮，它当需要的时候会被删除，所以不要在使用在栈中分配的对象，也就是使用new()来创建这个按钮。
<p> <p>也可以参考<a href="#setCancelButtonText">setCancelButtonText</a>()。

<h3 class=fn>void <a name="setCancelButtonText"></a>QProgressDialog::setCancelButtonText ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;cancelButtonText )<tt> [槽]</tt>
</h3>
设置取消按钮的文本为<em>cancelButtonText</em>。
<p>也可以参考<a href="#setCancelButton">setCancelButton</a>()。

<h3 class=fn>void <a name="setLabel"></a>QProgressDialog::setLabel ( <a href="qlabel.html">QLabel</a>&nbsp;*&nbsp;label )
</h3>
设置标签为<em>label</em>。进度对话框会重新定义大小来适合它。进度对话框会得到这个标签，它当需要的时候会被删除，所以不要在使用在栈中分配的对象，也就是使用new()来创建这个标签。
<p> <p>也可以参考<a href="#labelText-prop">labelText</a>。
<p>实例：<a href="progress-example.html#x51">progress/progress.cpp</a>。

<h3 class=fn>void <a name="setLabelText"></a>QProgressDialog::setLabelText ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp; )<tt> [槽]</tt>
</h3>
<p>设置标签的文本。详细情况请参考<a href="qprogressdialog.html#labelText-prop">“labelText”</a>属性。

<h3 class=fn>void <a name="setMinimumDuration"></a>QProgressDialog::setMinimumDuration ( int&nbsp;ms )<tt> [槽]</tt>
</h3>
<p>设置进度就应该在对话框打开之前运行的时间为<em>ms</em>。详细情况请参考<a href="qprogressdialog.html#minimumDuration-prop">“minimumDuration”</a>属性。

<h3 class=fn>void <a name="setProgress"></a>QProgressDialog::setProgress ( int&nbsp;progress )<tt> [槽]</tt>
</h3>
<p>设置进度当前的进度为<em>progress</em>。详细情况请参考<a href="qprogressdialog.html#progress-prop">“progress”</a>属性。

<h3 class=fn>void <a name="setTotalSteps"></a>QProgressDialog::setTotalSteps ( int&nbsp;totalSteps )<tt> [槽]</tt>
</h3>
<p>设置步数的总量为<em>totalSteps</em>。详细情况请参考<a href="qprogressdialog.html#totalSteps-prop">“totalSteps”</a>属性。

<h3 class=fn><a href="qsize.html">QSize</a> <a name="sizeHint"></a>QProgressDialog::sizeHint () const<tt> [虚]</tt>
</h3>
返回适合这个进度对话框内容的大小。如果需要进度对话框重新定义自己的大小，所以你应该不需要自己调用这个。

<h3 class=fn>int <a name="totalSteps"></a>QProgressDialog::totalSteps () const
</h3>
<p>返回步数的总量。详细情况请参考<a href="qprogressdialog.html#totalSteps-prop">“totalSteps”</a>属性。

<h3 class=fn>bool <a name="wasCancelled"></a>QProgressDialog::wasCancelled () const
</h3>
<p>如果对话框被取消，返回真，否则返回假。详细情况请参考<a href="qprogressdialog.html#wasCancelled-prop">“wasCancelled”</a>属性。

<hr><h2>属性文档</h2>
<h3 class=fn>bool <a name="autoClose-prop"></a>autoClose</h3>
<p>这个属性保存的是通过<a href="#reset">reset</a>()对话框是否隐藏。
<p>默认为真。
<p> <p>也可以参考<a href="#autoReset-prop">autoReset</a>。
<p>通过<a href="#setAutoClose">setAutoClose</a>()设置属性值并且通过<a href="#autoClose">autoClose</a>()来获得属性值。

<h3 class=fn>bool <a name="autoReset-prop"></a>autoReset</h3>
<p>这个属性保存的是一旦<a href="#progress">progress</a>()等于<a href="#totalSteps">totalSteps</a>()，进度对话框是否调用<a href="#reset">reset</a>()。
<p>默认为真。
<p> <p>也可以参考<a href="#autoClose-prop">autoClose</a>。
<p>通过<a href="#setAutoReset">setAutoReset</a>()设置属性值并且通过<a href="#autoReset">autoReset</a>()来获得属性值。


<h3 class=fn><a href="qstring.html">QString</a> <a name="labelText-prop"></a>labelText</h3>
<p>这个属性保存的是标签的文本。
<p>默认文本为<a href="qstring.html#QString-null">QString::null</a>。
<p>通过<a href="#setLabelText">setLabelText</a>()设置属性值并且通过<a href="#labelText">labelText</a>()来获得属性值。

<h3 class=fn>int <a name="minimumDuration-prop"></a>minimumDuration</h3>
<p>这个属性保存的是进度就应该在对话框打开之前运行的时间。
<p>如果正在进行的进度任务的被期待持续时间小于这个最小持续时间，对话框将不会显示。
<p> 如果被设置为0，一旦任何进度被设置，这个对话框就一直被显示。默认为4000毫秒。
<p>通过<a href="#setMinimumDuration">setMinimumDuration</a>()设置属性值并且通过<a href="#minimumDuration">minimumDuration</a>()来获得属性值。

<h3 class=fn>int <a name="progress-prop"></a>progress</h3>
<p>这个属性保存的是进度当前的进度。
<p>对于正如所期望的运行的进度对话框，你应该初始化设置这个属性为0并且最后把它设置为<a href="#totalSteps">QProgressDialog::totalSteps</a>()，你可以在这之间调用<a href="#setProgress">setProgress</a>()任意次。
<p> <b>警告：</b> 如果进度对话框是模式的（请参考<a href="#QProgressDialog">QProgressDialog::QProgressDialog</a>())），这个函数调用<a href="qapplication.html#processEvents">QApplication::processEvents</a>()，所以注意这个函数不会导致不受欢迎的重新进入你的代码。例如，不要在<a href="qwidget.html#paintEvent">paintEvent</a>()中使用QProgressDialog！
<p> <p>也可以参考<a href="#totalSteps-prop">totalSteps</a>。
<p>通过<a href="#setProgress">setProgress</a>()设置属性值并且通过<a href="#progress">progress</a>()来获得属性值。

<h3 class=fn>int <a name="totalSteps-prop"></a>totalSteps</h3>
<p>这个属性保存的是步数的总量。
<p>默认为0。
<p>通过<a href="#setTotalSteps">setTotalSteps</a>()设置属性值并且通过<a href="#totalSteps">totalSteps</a>()来获得属性值。

<h3 class=fn>bool <a name="wasCancelled-prop"></a>wasCancelled</h3>
<p>这个属性保存的是对话框是否被取消。
<p><p><p>也可以参考<a href="#progress-prop">progress</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>