📄 qtabdialog.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/reggie/tmp/qt-3.0-reggie-5401/qt-x11-commercial-3.0.5/src/dialogs/qtabdialog.cpp:53 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<meta name="Translator" content="Cavendish">
<meta name="Qt zh_CN Documents Website" content="http://www.qiliang.net/qt">
<title>QTabDialog类</title>
<style type="text/css"><!--
h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; font-family: "Times New Roman" }
--></style>
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr bgcolor="#E5E5E5">
<td valign=center>
<a href="index.html">
<font color="#004faf">主页</font></a>
| <a href="classes.html">
<font color="#004faf">所有的类</font></a>
| <a href="mainclasses.html">
<font color="#004faf">主要的类</font></a>
| <a href="annotated.html">
<font color="#004faf">注释的类</font></a>
| <a href="groups.html">
<font color="#004faf">分组的类</font></a>
| <a href="functions.html">
<font color="#004faf">函数</font></a>
</td>
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table>
<h1 align=center>QTabDialog类参考</h1>
<p>QTabDialog类提供了一个被标签的窗口部件的栈。
<a href="#details">详情请见……</a>
<p><tt>#include <<a href="qtabdialog-h.html">qtabdialog.h</a>></tt>
<p>继承了<a href="qdialog.html">QDialog</a>。
<p><a href="qtabdialog-members.html">所有成员函数的列表。</a>
<h2>公有成员</h2>
<ul>
<li><div class=fn><a href="#QTabDialog"><b>QTabDialog</b></a> ( QWidget * parent = 0, const char * name = 0, bool modal = FALSE, WFlags f = 0 )</div></li>
<li><div class=fn><a href="#~QTabDialog"><b>~QTabDialog</b></a> ()</div></li>
<li><div class=fn>virtual void <a href="#setFont"><b>setFont</b></a> ( const QFont & font )</div></li>
<li><div class=fn>void <a href="#addTab"><b>addTab</b></a> ( QWidget * child, const QString & label )</div></li>
<li><div class=fn>void <a href="#addTab-2"><b>addTab</b></a> ( QWidget * child, const QIconSet & iconset, const QString & label )</div></li>
<li><div class=fn>void <a href="#addTab-3"><b>addTab</b></a> ( QWidget * child, QTab * tab )</div></li>
<li><div class=fn>void <a href="#insertTab"><b>insertTab</b></a> ( QWidget * child, const QString & label, int index = -1 )</div></li>
<li><div class=fn>void <a href="#insertTab-2"><b>insertTab</b></a> ( QWidget * child, const QIconSet & iconset, const QString & label, int index = -1 )</div></li>
<li><div class=fn>void <a href="#insertTab-3"><b>insertTab</b></a> ( QWidget * child, QTab * tab, int index = -1 )</div></li>
<li><div class=fn>void <a href="#changeTab-2"><b>changeTab</b></a> ( QWidget * w, const QString & label )</div></li>
<li><div class=fn>void <a href="#changeTab"><b>changeTab</b></a> ( QWidget * w, const QIconSet & iconset, const QString & label )</div></li>
<li><div class=fn>bool <a href="#isTabEnabled"><b>isTabEnabled</b></a> ( QWidget * w ) const</div></li>
<li><div class=fn>void <a href="#setTabEnabled"><b>setTabEnabled</b></a> ( QWidget * w, bool enable )</div></li>
<li><div class=fn>bool isTabEnabled ( const char * name ) const <em>（废弃）</em></div></li>
<li><div class=fn>void setTabEnabled ( const char * name, bool enable ) <em>（废弃）</em></div></li>
<li><div class=fn>void <a href="#showPage"><b>showPage</b></a> ( QWidget * w )</div></li>
<li><div class=fn>void <a href="#removePage"><b>removePage</b></a> ( QWidget * w )</div></li>
<li><div class=fn>QString <a href="#tabLabel"><b>tabLabel</b></a> ( QWidget * w )</div></li>
<li><div class=fn>QWidget * <a href="#currentPage"><b>currentPage</b></a> () const</div></li>
<li><div class=fn>void <a href="#setDefaultButton"><b>setDefaultButton</b></a> ( const QString & text )</div></li>
<li><div class=fn>void <a href="#setDefaultButton-2"><b>setDefaultButton</b></a> ()</div></li>
<li><div class=fn>bool <a href="#hasDefaultButton"><b>hasDefaultButton</b></a> () const</div></li>
<li><div class=fn>void <a href="#setHelpButton"><b>setHelpButton</b></a> ( const QString & text )</div></li>
<li><div class=fn>void <a href="#setHelpButton-2"><b>setHelpButton</b></a> ()</div></li>
<li><div class=fn>bool <a href="#hasHelpButton"><b>hasHelpButton</b></a> () const</div></li>
<li><div class=fn>void <a href="#setCancelButton"><b>setCancelButton</b></a> ( const QString & text )</div></li>
<li><div class=fn>void <a href="#setCancelButton-2"><b>setCancelButton</b></a> ()</div></li>
<li><div class=fn>bool <a href="#hasCancelButton"><b>hasCancelButton</b></a> () const</div></li>
<li><div class=fn>void <a href="#setApplyButton"><b>setApplyButton</b></a> ( const QString & text )</div></li>
<li><div class=fn>void <a href="#setApplyButton-2"><b>setApplyButton</b></a> ()</div></li>
<li><div class=fn>bool <a href="#hasApplyButton"><b>hasApplyButton</b></a> () const</div></li>
<li><div class=fn>void <a href="#setOkButton"><b>setOkButton</b></a> ( const QString & text )</div></li>
<li><div class=fn>void <a href="#setOkButton-2"><b>setOkButton</b></a> ()</div></li>
<li><div class=fn>bool <a href="#hasOkButton"><b>hasOkButton</b></a> () const</div></li>
</ul>
<h2>信号</h2>
<ul>
<li><div class=fn>void <a href="#aboutToShow"><b>aboutToShow</b></a> ()</div></li>
<li><div class=fn>void <a href="#applyButtonPressed"><b>applyButtonPressed</b></a> ()</div></li>
<li><div class=fn>void <a href="#cancelButtonPressed"><b>cancelButtonPressed</b></a> ()</div></li>
<li><div class=fn>void <a href="#defaultButtonPressed"><b>defaultButtonPressed</b></a> ()</div></li>
<li><div class=fn>void <a href="#helpButtonPressed"><b>helpButtonPressed</b></a> ()</div></li>
<li><div class=fn>void <a href="#currentChanged"><b>currentChanged</b></a> ( QWidget * )</div></li>
<li><div class=fn>void selected ( const QString & ) <em>（废弃）</em></div></li>
</ul>
<h2>保护成员</h2>
<ul>
<li><div class=fn>void <a href="#setTabBar"><b>setTabBar</b></a> ( QTabBar * tb )</div></li>
<li><div class=fn>QTabBar * <a href="#tabBar"><b>tabBar</b></a> () const</div></li>
</ul>
<hr><a name="details"></a><h2>详细描述</h2>
<p> QTabDialog类提供了一个被标签的窗口部件的栈。
<p>
<p> 被标签的对话框就是一个在里面有几个“标签页”是可用的对话框。通过点击标签页的标签或者通过按下被指出的Alt+<em>letter</em>键组合，用户可以选择他们想使用的标签页。
<p> QTabDialog提供了一个由标签组成的单一一排在上面组成的标签栏，每一个标签都有一个关联的窗口部件包含着那个标签的标签页。另外，QTabDialog提供了一个OK按钮和下述几个可选按钮：Apply、Cancel、Defaults和Help。
<p> 使用QTabDialog的常用方法是在构造函数中像下面这样做：
<ol type=1>
<li> 创建一个QTabDialog。
<li> 为标签对话框中的每一个页面创建一个<a href="qwidget.html">QWidget</a>，把它们的自对象插入进去，为它们设置几何形状管理，并且使用<a href="#addTab">addTab</a>()（或者<a href="#insertTab">insertTab</a>()）来为它设置一个标签和键盘快捷键。
<li> 使用<a href="#setOkButton">setOkButton</a>()、<a href="#setApplyButton">setApplyButton</a>()、setDefaultsButton()、<a href="#setCancelButton">setCancelButton</a>()和<a href="#setHelpButton">setHelpButton</a>()为标签对话框设置按钮。
<li> 连接信号和槽。
</ol>
<p> 如果你没有调用addTab()，你已经创建的页面将不是可见的。不要把你提供给QWidget构造函数的对象名称和你提供给addTab()的标签弄混，addTab()中的是出现在窗口部件的标签伤得用户可视名称并且可以有一个快捷键，而窗口部件的名称主要用语调试。
<p> 几乎所有应用程序不得不把<a href="#applyButtonPressed">applyButtonPressed</a>()信号连接到什么上，当OK或者Apply被点击时，applyButtonPressed()被发射，并且你的槽必须复制对话框的状态到应用程序中。
<p> 这里有其它几个可能有用的信号：
<ul>
<li> <a href="#cancelButtonPressed">cancelButtonPressed</a>() is emitted when the user clicks Cancel.
当用户点击Cancel时，<a href="#cancelButtonPressed">cancelButtonPressed</a>()被发射。
<li> 当用户点击Defaults时，<a href="#defaultButtonPressed">defaultButtonPressed</a>()被发射，它被连接的槽应该重置这个对话框为应用程序的默认值。
<li> 当用户点击Help时，<a href="#helpButtonPressed">helpButtonPressed</a>()被发射。
<li> 在<a href="qdialog.html#show">show</a>()开始时，<a href="#aboutToShow">aboutToShow</a>()被发射，如果在标签对话框的创建和show()被调用的时候之间有应用程序的状态发生改变的机会，你必须把这个信号连接到重置对话框状态的槽上。
<li> 当用户选择一个页时，<a href="#currentChanged">currentChanged</a>()被发射。
</ul>
<p> 每个标签在任何给定的时间都可以是生效的或者失效的（请参考<a href="#setTabEnabled">setTabEnabled</a>()）。如果一个标签生效，标签文本就会被绘制为黑色并且用户可以选择这个标签。如果一个标签失效，标签文本就会被一种不同的方式绘制并且用户也就不可以选择它了。注意，尽管一个标签是失效的，这页仍是可见的，例如，如果所有的标签都变为失效了。
<p> 你可以使用<a href="#changeTab">changeTab</a>()来改变标签的文本和图标集。标签页可以用<a href="#removePage">removePage</a>()移除并且用<a href="#showPage">showPage</a>()显示。当前页由<a href="#currentPage">currentPage</a>()给定。
<p> QTabDialog不支持在侧面或者底下的标签，你也不能设置或者重新找回可见的页。如果你需要比QTabDialog提供的更多的功能，可以考虑考虑使用可以放置QTabWidget的<a href="qtabbar.html">QTabBar</a>的<a href="qdialog.html">QDialog</a>。
<p> QTabDialog的绝大部分功能是由<a href="qtabwidget.html">QTabWidget</a>提供的。
<p> <img src=qtabdlg-m.png> <img src=qtabdlg-w.png>
<p> <p>也可以参考<a href="qdialog.html">QDialog</a>和<a href="dialogs.html">对话框类</a>。
<hr><h2>成员函数文档</h2>
<h3 class=fn><a name="QTabDialog"></a>QTabDialog::QTabDialog ( <a href="qwidget.html">QWidget</a> * parent = 0, const char * name = 0, bool modal = FALSE, WFlags f = 0 )
</h3>
构造一个只有OK按钮的QTabDialog。<em>parent</em>、<em>name</em>、<em>modal</em>和<a href="qt.html#WidgetFlags">窗口部件标记</a><em>f</em>参数被传递给<a href="qdialog.html">QDialog</a>的构造函数。
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -