QTabWidget 类 (选项卡部件)

1、 QTabWidget 类直接继承自 QWidget。该类提供了一个选项卡栏(QTabBar)和一个相应的页 面区域，用于显示与每个选项卡相对应的页面。 与 QStackedLayout 布局原理相同，只有 当前页面(即可见页面)是可见的，所有其他页面都不可见，用户可通过选择不同的选项卡

来显示其对应的其他页面。 2、页面或页面部件：其实就是容器(通常使用 QWidget 创建) 3、 QTabWidget 类，是一个实现多页面切换的类，该类已经实现了多页面切换的部分功能， 只需再对其进行少量的设计(主要是要设计页面中的内容)便可实现多页面切换了。 因此， 使用该类实现多页面切换时，就不需要再使用 QStackedLayout 布局把页面与选项卡相关 联，也不需要使用类似 QVBoxLayout 的布局把选项卡和页面放置在一起。 4、 QTabWidget 类的大部分功能由 QTabBar(主要处理选项卡部分)和 QStackedWidget(主要处 理组织页面的功能)提供。

5、 使用 QTabWidget 的步骤为： ①、 创建一个 QTabWidget。 ②、 为每个选项卡创建一个页面(容器)，通常为 QWidget(不要指定父部件)。 ③、 把子部件插入到页面部件(即容器)中。 ④、 使用 addTab()或 insertTab()把页面部件放入选项卡部件。 ⑤、下面为大致代码

⑥、 注：若容器中的内容不可见，则使用 resize()函数设置 QTabWidget 的大小使其可见

6、 QTabWidget 类中的属性和函数大多与 QTabBar 中的属性和函数是相同的，对于相同的属 性和函数此处仅列出，只讲解不相同的属性和函数。

7、 QTabWidget 类中的属性

①、 tabBarAutoHide： bool //qt5.4 访问函数： bool tabBarAutoHide(); void setTabBarAutoHide(bool); 若为 true，则当选项卡只有 1 个时，会自动隐藏，默认为 false。该属性对应于 QTabBar 的 autoHide 属性。 ②、 tabPosition： TabPosition 访问函数： TabPosition tabPosition()const; void setTabPosition(TabPosition); 获取或设置选项卡的位置(即选项卡位于上、下、左、右)。默认为 North(即上)。

TabPosition 枚举见下表

③、 tabShape： TabShape 访问函数： TabShape tabShape() const; void setTabShape(TabShape); 此属性描述选项卡的形状，该属性对应于 QTabBar 的 shape 属性，其外观可参阅该类

7、 QTabWidget 类中的函数 ①、 QTabWidget(QWidget* parent = Q_NULLPTR); //构造函数 ②、 int addTab(QWidget* page, const QString &label); int addTab(QWidget* page, const QIcon &icon, const QString &label); int insert(int index, QWidget* page, const QString &label); int insert(int index, QWidget* page, const QIcon &icon, const QString &label);  以上函数表示，把页面部件 page 和具有文本 label 和(或)图标 icon 的选项卡添加 到 QTabWidget 部件的末尾或插入到索引 index 处，并返回选项卡栏上该选项卡的 索引。  其中 label 和 icon 会成为选项卡的文本和图标。  可在 label 的文本中使用&符号为选项卡设置快捷键。  若在小于或等于当前选项卡索引的索引处插入一个新选项卡，将使当前选项卡的 索引号增加，但当前选项卡保持不变。  若以上函数在 show()之后调用，则可能会导致闪烁现象。 ③、 void clear(); 移除所有页面，但不删除它们。调用此函数相当于调用 removeTab()函数直到选项卡部 件为空。 ④、 void removeTab(int index); //移除索引 index 处的选项卡，页面不会被删除。

⑤、 int indexOf(QWidget* w) const; //返回部件 w 的索引位置，若没有该部件则返回-1 ⑥、 QWidget* widget(int index) const; //返回索引 index 处的页面部件。 ⑦、 QWidget* currentWidget() const; //返回指向当前页面部件的指针。

⑧、 QTabBar* tabBar() const;void setTabBar(QTabBar* tb);    //返回当前的 QTabBar。//受保护的。

使用 tb 替换选项卡部件的 QTabBar 选项卡栏，注意：必须在添加任何其他选项卡之前 调用此函数，否则将是未定义的。 ⑨、 QWidget* cornerWidget(Qt::Corner corner = Qt::TopRightCorner) const; 返回角落 corner 处的小部件或 0。 void setCornerWidget(QWidget* widget, Qt::Corner corner = Qt::TopRightCorner); 把部件 widget 添加到指定的角落 corner 处(效果见下图)。仅选项卡位于上方或下方时 才能使用。

8、 QTabWidget 类中的信号 ①、 void currentChanged(int index); //信号 当选项卡栏上的当前选项卡发生更改时发送此信号， index 为新选项卡的索引，若没 有新的索引，则为-1(比如 QTabBar 中没有选项卡)。该信号比较重要。

②、 void tabBarClicked(int index);    //信号， qt5.2 void tabBarDoubleClicked(int index);    //信号， qt5.2

以上信号表示，单击或双击 index 处的选项卡时发送此信号， index 是单击选项卡的索 引，若光标下没有选项卡，则为-1。 ③、 void tabCloseRequested(int index); //信号 当点击选项卡上的关闭按钮时发送此信号， index 为应删除的选项卡的索引。