qtabdialog.html

QT参考文档

<h3 class=fn><a name="~QTabDialog"></a>QTabDialog::~QTabDialog ()
</h3>
销毁这个标签对话框。

<h3 class=fn>void <a name="aboutToShow"></a>QTabDialog::aboutToShow ()<tt> [信号]</tt>
</h3>
<p> 当设置对话框的内容的状态的时候，这个信号被<a href="qdialog.html#show">show</a>()发射。对话框应该反映当它出现的时候应用程序的当前状态，如果在你调用<a href="#QTabDialog">QTabDialog::QTabDialog</a>()和<a href="qdialog.html#show">QTabDialog::show</a>()之间，有改变应用程序的状态的可能性的话，你应该在一个槽中设置对话框的状态并且把它和这个信号连接起来。
<p> 这主要适用于保持隐藏的QTabDialog对象，而不是那些被创建、被显示然后被删除的。
<p> <p>也可以参考<a href="#applyButtonPressed">applyButtonPressed</a>()、<a href="qdialog.html#show">show</a>()和<a href="#cancelButtonPressed">cancelButtonPressed</a>()。

<h3 class=fn>void <a name="addTab"></a>QTabDialog::addTab ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;child, const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;label )
</h3>
把另外一个标签和页添加到这个标签视中。
<p> 新的页是<em>child</em>，标签文本是<em>label</em>。注意窗口部件名称（你提供给窗口部件构造函数和给<a href="#setTabEnabled">setTabEnabled</a>()的，例如）和标签文本的不同。这个窗口部件名称用于应用程序内部并且是不变的，而标签文本是被显示在屏幕上并且可以根据语言和其它因素变化的。
<p> 如果标签的<em>label</em>包含“&amp;”，那么在“&amp;”后面的字符就会被用作这个标签的快捷键，例如，如果标签为“Bro&wse”，那么Alt+W就变成了快捷键，它会使焦点移到这个标签的。
<p> 如果在<a href="qdialog.html#show">show</a>()之后调用<a href="#addTab">addTab</a>()，屏幕将会闪烁并且用户也许会困惑。
<p> <p>也可以参考<a href="#insertTab">insertTab</a>()。

<h3 class=fn>void <a name="addTab-2"></a>QTabDialog::addTab ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;child, const&nbsp;<a href="qiconset.html">QIconSet</a>&nbsp;&amp;&nbsp;iconset, const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;label )
</h3> 
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 这个版本的函数显示<em>child</em>标签上的<em>iconset</em>和<em>label</em>。

<h3 class=fn>void <a name="addTab-3"></a>QTabDialog::addTab ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;child, <a href="qtab.html">QTab</a>&nbsp;*&nbsp;tab )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 这是一个添加标签的底层方法，和其它<a href="#addTab">addTab</a>()方法相似。如果你正在使用<a href="#setTabBar">setTabBar</a>()来设置一个<a href="qtabbar.html">QTabBar</a>继承类并且为<a href="qtab.html">QTab</a>的子类重载<a href="qtabbar.html#paint">QTabBar::paint</a>()函数，这个方法就很有用了。
<p> <em>child</em>是要被放置到新标签页的窗口部件。<em>tab</em>就是要显示在标签页上的标签——通常它显示一个标签文本或者一个图标来标识标签页。

<h3 class=fn>void <a name="applyButtonPressed"></a>QTabDialog::applyButtonPressed ()<tt> [信号]</tt>
</h3>
<p> 当Apply或者OK按钮之一被点击时，这个信号被发射。
<p> 它应该被连接到一个（或几个）根据对话框状态改变应用程序状态的槽。
<p> <p>也可以参考<a href="#cancelButtonPressed">cancelButtonPressed</a>()、<a href="#defaultButtonPressed">defaultButtonPressed</a>()和<a href="#setApplyButton">setApplyButton</a>()。

<h3 class=fn>void <a name="cancelButtonPressed"></a>QTabDialog::cancelButtonPressed ()<tt> [信号]</tt>
</h3>
<p> 当Cancel按钮被点击时，这个信号被发射。它自动被连接到将会隐藏对话框的<a href="qdialog.html#reject">QDialog::reject</a>()。
<p> Cancel按钮一点也不会改变应用程序的状态，所以你应该不需要把它和任何槽连接起来。
<p> <p>也可以参考<a href="#applyButtonPressed">applyButtonPressed</a>()、<a href="#defaultButtonPressed">defaultButtonPressed</a>()和<a href="#setCancelButton">setCancelButton</a>()。

<h3 class=fn>void <a name="changeTab"></a>QTabDialog::changeTab ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;w, const&nbsp;<a href="qiconset.html">QIconSet</a>&nbsp;&amp;&nbsp;iconset, const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;label )
</h3>
改变标签页<em>w</em>的图标集和标签文本分别为<em>iconset</em>和<em>label</em>。

<h3 class=fn>void <a name="changeTab-2"></a>QTabDialog::changeTab ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;w, const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;label )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 为标签页<em>w</em>定义新的<em>label</em>。

<h3 class=fn>void <a name="currentChanged"></a>QTabDialog::currentChanged ( <a href="qwidget.html">QWidget</a>&nbsp;* )<tt> [信号]</tt>
</h3> 
<p> 只要当前页发生改变，这个信号就被发射。
<p> <p>也可以参考<a href="#currentPage">currentPage</a>()、<a href="#showPage">showPage</a>()和<a href="#tabLabel">tabLabel</a>()。

<h3 class=fn><a href="qwidget.html">QWidget</a>&nbsp;* <a name="currentPage"></a>QTabDialog::currentPage () const
</h3>  
返回当前正在被标签对话框显示的页的指针。标签对话框会尽它最大努力来保证这个值不会为0（但是如果你也足够努力的话，它可能就是了）。

<h3 class=fn>void <a name="defaultButtonPressed"></a>QTabDialog::defaultButtonPressed ()<tt> [信号]</tt>
</h3>
<p> 当Defaults按钮被按下时，这个信号被发射。它应该重置对话框（但不是应用程序）为“出厂默认设置”。
<p> 直到用户点击Apply或者OK之前，应用程序的状态不应改变。
<p> <p>也可以参考<a href="#applyButtonPressed">applyButtonPressed</a>()、<a href="#cancelButtonPressed">cancelButtonPressed</a>()和<a href="#setDefaultButton">setDefaultButton</a>()。

<h3 class=fn>bool <a name="hasApplyButton"></a>QTabDialog::hasApplyButton () const
</h3>
如果标签对话框已经有了一个Apply按钮，返回真，否则返回假。
<p> <p>也可以参考<a href="#setApplyButton">setApplyButton</a>()、<a href="#applyButtonPressed">applyButtonPressed</a>()、<a href="#hasCancelButton">hasCancelButton</a>()和<a href="#hasDefaultButton">hasDefaultButton</a>()。

<h3 class=fn>bool <a name="hasCancelButton"></a>QTabDialog::hasCancelButton () const
</h3>
如果标签对话框已经有了一个Cancel按钮，返回真，否则返回假。
<p> <p>也可以参考<a href="#setCancelButton">setCancelButton</a>()、<a href="#cancelButtonPressed">cancelButtonPressed</a>()、<a href="#hasApplyButton">hasApplyButton</a>()和<a href="#hasDefaultButton">hasDefaultButton</a>()。

<h3 class=fn>bool <a name="hasDefaultButton"></a>QTabDialog::hasDefaultButton () const
</h3>
如果标签对话框已经有了一个Defaults按钮，返回真，否则返回假。
<p> <p>也可以参考<a href="#setDefaultButton">setDefaultButton</a>()、<a href="#defaultButtonPressed">defaultButtonPressed</a>()、<a href="#hasApplyButton">hasApplyButton</a>()和<a href="#hasCancelButton">hasCancelButton</a>()。

<h3 class=fn>bool <a name="hasHelpButton"></a>QTabDialog::hasHelpButton () const
</h3>
如果标签对话框已经有了一个Help按钮，返回真，否则返回假。
<p> <p>也可以参考<a href="#setHelpButton">setHelpButton</a>()、<a href="#helpButtonPressed">helpButtonPressed</a>()、<a href="#hasApplyButton">hasApplyButton</a>()和<a href="#hasCancelButton">hasCancelButton</a>()。

<h3 class=fn>bool <a name="hasOkButton"></a>QTabDialog::hasOkButton () const
</h3>
如果标签对话框已经有了一个OK按钮，返回真，否则返回假。
<p> <p>也可以参考<a href="#setOkButton">setOkButton</a>()、<a href="#hasApplyButton">hasApplyButton</a>()、<a href="#hasCancelButton">hasCancelButton</a>()和<a href="#hasDefaultButton">hasDefaultButton</a>()。

<h3 class=fn>void <a name="helpButtonPressed"></a>QTabDialog::helpButtonPressed ()<tt> [信号]</tt>
</h3>
<p> 当Help按钮被按下时，这个信号被发射。它可以用来呈现关于如何使用这个对话框的信息。
<p> <p>也可以参考<a href="#applyButtonPressed">applyButtonPressed</a>()、<a href="#cancelButtonPressed">cancelButtonPressed</a>()和<a href="#setHelpButton">setHelpButton</a>()。

<h3 class=fn>void <a name="insertTab"></a>QTabDialog::insertTab ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;child, const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;label, int&nbsp;index = -1 )
</h3>
在标签视中插入另一个标签和页。
<p> 新的页是<em>child</em>，标签文本是<em>label</em>。注意窗口部件名称（你提供给窗口部件构造函数和给<a href="#setTabEnabled">setTabEnabled</a>()的，例如）和标签文本的不同。这个窗口部件名称用于应用程序内部并且是不变的，而标签文本是被显示在屏幕上并且可以根据语言和其它因素变化的。
<p> 如果标签的<em>label</em>包含“&amp;”，那么在“&amp;”后面的字符就会被用作这个标签的快捷键，例如，如果标签为“Bro&wse”，那么Alt+W就变成了快捷键，它会使焦点移到这个标签的。
<p> 如果<em>index</em>没有被指定，那么这个标签只是被简单添加。否则它就会被插入在特定位置。
<p> 如果在<a href="qdialog.html#show">show</a>()之后调用<a href="#insertTab">insertTab</a>()，屏幕将会闪烁并且用户也许会困惑。
<p> <p>也可以参考<a href="#addTab">addTab</a>()。

<h3 class=fn>void <a name="insertTab-2"></a>QTabDialog::insertTab ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;child, const&nbsp;<a href="qiconset.html">QIconSet</a>&nbsp;&amp;&nbsp;iconset, const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;label, int&nbsp;index = -1 )
</h3> 
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 这个版本的函数显示<em>child</em>标签上的<em>iconset</em>和<em>label</em>。

<h3 class=fn>void <a name="insertTab-3"></a>QTabDialog::insertTab ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;child, <a href="qtab.html">QTab</a>&nbsp;*&nbsp;tab, int&nbsp;index = -1 )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 这是一个添加标签的底层方法，和其它<a href="#insertTab">insertTab</a>()方法相似。如果你正在使用<a href="#setTabBar">setTabBar</a>()来设置一个<a href="qtabbar.html">QTabBar</a>继承类并且为<a href="qtab.html">QTab</a>的子类重载<a href="qtabbar.html#paint">QTabBar::paint</a>()函数，这个方法就很有用了。
<p> <em>child</em>是要被放置到新标签页的窗口部件。<em>tab</em>就是要显示在标签页上的标签——通常它显示一个标签文本或者一个图标来标识标签页。<em>index</em>是这个标签页应该被插入的位置。

<h3 class=fn>bool <a name="isTabEnabled"></a>QTabDialog::isTabEnabled ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;w ) const
</h3>
如果页<em>w</em>是生效的，返回真，否则返回假。
<p> <p>也可以参考<a href="#setTabEnabled">setTabEnabled</a>()和<a href="qwidget.html#enabled-prop">QWidget::enabled</a>。

<h3 class=fn>bool <a name="isTabEnabled-2"></a>QTabDialog::isTabEnabled ( const&nbsp;char&nbsp;*&nbsp;name ) const
</h3> 
<p> <b>这个函数是废弃的。</b>它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。
<p> 如果对象名称为<em>name</em>的页是生效的，返回真，否则返回假。
<p> 如果<em>name</em>为0或者没有这样一个名称的页，<a href="#isTabEnabled">isTabEnabled</a>()返回假。
<p> <p>也可以参考<a href="#setTabEnabled">setTabEnabled</a>()和<a href="qwidget.html#enabled-prop">QWidget::enabled</a>。

<h3 class=fn>void <a name="removePage"></a>QTabDialog::removePage ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;w )
</h3>