QGridLayout
#include <QGridLayout>
QGridLayout类采用的是表格布局排列的形式,继承自QLayout。
1、详细描述
栅格布局将位于其中的窗口部件放入一个网状的栅格之中。QGridLayout需要将提供给它的空间划分成的行和列,并把每个窗口控件插入并管理到正确的单元格。
栅格布局是这样工作的:
它计算了位于其中的空间,然后将它们合理的划分成若干个行(row)和列(column),并 把每个由它管理的窗口部件放置在合适的单元之中,这里所指的单元(cell)即是指由行和列交叉所划分出来的空间。
在栅格布局中,行和列本质上是相同的,只是叫法不同而已。下面我们将重点讨论列,这些内容当然也适用于行。
在栅格布局中,每个列(以及行)都有一个最小宽度(minimumwidth)以及一个伸缩因子(stretchfactor)。最小宽度指的是位于该列中的窗口部件的最小的宽度,而伸缩因子决定了该列内的窗口部件能够获得多少空间。它们的值可以通过setColumnMinimumWidth()和setColumnStretch()方法来设置。
此外,一般情况下我们都是把某个窗口部件放进栅格布局的一个单元中,但窗口部件有时也可能会需要占用多个单元。这时就需要用到addWidget()方法的一个重载版本,它的原型如下:
void QGridLayout::addWidget(QWidget *widget, int fromRow, int fromColumn,int rowSpan, int columnSpan,Qt::Alignment alignment = 0 )
这时这个单元将从fromRow和fromColumn开始,扩展到rowSpan和columnSpan指定 的倍数的行和列。如果rowSpan或columnSpan的值为-1,则窗口部件将扩展到布局的底部或者右边边缘处。
小贴士:栅格布局中的某个单元(cell)的长和宽,也可以说是栅格布局的行和列的尺寸并
不是一样大小的。如果你想使它们相等,你必须通过调用setColumnMinimumWidth()和 setColumnStretch()方法来使得它们的最小宽度以及伸缩因子都彼此相等。
如果QGridLayout不是窗体的顶层布局(就是说它不能管理所有的区域和子窗口部 件),那么当你创建它的同时,就必须为它指定一个父布局,也就是把它加入到父布局中去,并且在此之前,不要对它做任何的操作。使用addLayout()方法可以完成这一动作。
在创建栅格布局完成后,就可以使用addWidget(),addItem(),以及addLayout()方法向其中加入窗口部件,以及其它的布局。
当界面元素较为复杂时,应该毫不犹豫的尽量使用栅格布局,而不是使用水平和垂直布局的组合或者嵌套的形式,因为在多数情况下,后者往往会使“局势”更加复杂而难以控制。栅格布局赋予了界面设计器更大的自由度来排列组合界面元素,而仅仅带来了微小的复杂度开销。
当要设计的界面是一种类似于两列和若干行组成的形式时,使用表单布局要比栅格布 局更为方便些。
2、属性
horizontalSpacing : int
这个属性用来保存的布局管理器中的水平控件之间的间距。
如果没有值显式设置,布局管理器的水平间距是继承自父布局管理器,或者从父窗口的样式设置。
columnspan是什么意思相关函数:int horizontalSpacing () const
void setHorizontalSpacing ( int spacing )
verticalSpacing : int
这个属性用来保存的布局管理器中的垂直控件之间的间距。
如果没有值显式设置,布局管理器的垂直间距是继承自父布局管理器,或者从父窗口的样式设置。
相关函数:int verticalSpacing () const
void setVerticalSpacing (int spacing )
3、成员函数文档
QGridLayout::QGridLayout ( QWidget * parent )
构造一个父窗口为parent的新的QGridLayout。布局管理器最初具有一行和一列,在插入新的项目时将扩大。
QGridLayout::QGridLayout ()
构造一个栅格布局管理器。
你必须将这个栅格布局管理器到另一个布局管理器中。您可以随时插入控件和管理这个布局管理器,但此布局管理器在被插入到另一个布局之前将不会被执行布局管理。
QGridLayout::~QGridLayout ()
析构这个网格布局,但布局管理器中的控件不会被破坏。
void QGridLayout::addItem ( QLayoutItem * item, int row, int column, int rowSpan = 1, int columnSpan = 1, Qt::Alignment alignment = 0 )
其中,widget是要插入到布局中的子窗口部件,(row,column)是由该窗口部件所占用的左上角单元格,rowSpan是该窗口部件要占用的行数,而column是该窗口部件要占用的列数
警告:请勿使用此函数来添加子布局管理器或子窗口部件项目。使用addLayout()或addWidget()来代替。
void QGridLayout::addItem ( QLayoutItem * item ) [virtual protected]
纯虚函数,其实现子类必须实现。
执行在子类中添加一个项目。这个功能并不是通常所说的应用程序代码。由相关QLayout子类提供函数,使用addWidget()将一个控件添加到布局管理器中,使用addLayout(),将一个布局管理器添加到另一个布局管理器中。
void QGridLayout::addLayout ( QLayout * layout, int row, int column, Qt::Alignment alignment = 0 )
将这个布局管理器layout放置到(row, column)的网格中,左上端的位置为(0, 0)。
该对齐方式由alignment指定。默认的对齐是0,这意味着该插件充满整个单元格。
alignment为非零值意味着该控件不能填充整个控件,而是应该根据sizeHint()的大小。
Layout管理器将成为该栅格布局管理器中的一个孩子。
void QGridLayout::addLayout(QLayout *layout,int row,int column,int rowSpan,int columnSpan, Qt::Alignment alignment =0)
这是一个重载函数。这时这个单元将从fromRow和fromColumn开始,扩展到rowSpan和colu
mnSpan指定 的倍数的行和列。如果rowSpan或columnSpan的值为-1,则窗口部件将扩展到布局的底部或者右边边缘处。
void QGridLayout::addWidget ( QWidget * widget, int row, int column, Qt::Alignment alignment = 0 )
将指定的窗口控件插入到指定的row, column的单元格内。默认左上位置为(0, 0) 。该对齐方式由alignment指定。默认的对齐是0,这意味着该插件充满整个单元格。
void QGridLayout::addWidget ( QWidget * widget, int fromRow, int fromColumn, int rowSpan, int columnSpan, Qt::Alignment alignment = 0 )
这是一个重载函数。这时这个单元将从fromRow和fromColumn开始,扩展到rowSpan和columnSpan指定 的倍数的行和列。这个窗口控件已经给予了对齐方式alignment。
如果rowSpan或columnSpan的值为-1,则窗口部件将扩展到布局的底部或者右边边缘处。
QRect QGridLayout::cellRect ( int row, int column ) const
返回row,column所在控件的单元格的几何形状。如果row或者column超出了网格表的范围则返回一个无效的矩形。
警告:在Qt中的当前版本此函数不返回有效的结果,直到setGeometry()被调用,即在parentWidget()是有效的以后。
int QGridLayout::columnCount () const
返回该栅格布局管理器的列数。
int QGridLayout::columnMinimumWidth ( int column ) const
返回该栅格布局管理器中的column列列间距。
int QGridLayout::columnStretch ( int column ) const
返回该栅格布局管理器中的column列的拉伸因子。
int QGridLayout::count () const [virtual]
纯虚函数,表示此布局管理器中的控件数量
Qt::Orientations QGridLayout::expandingDirections () const [virtual]
返回layout扩展的方向,一般是Qt::Vertical或者Qt::Horizontal表示只想一个方向grow,否则是两个方向。
void QGridLayout::getItemPosition (int index, int * row, int * column, int * rowSpan, int * columnSpan )
返回给定的index来返回项目的位置信息。通过变量row和column为该项目在布局中的位置更新,并且通过变量rowSPAN和columnSpan对该项目的垂直和水平跨度更新。