Question

QGroupBox窗口部件提供了一个有标题的组合框。 详情请见……

#include <qgroupbox.h>

继承了QFrame。

被QButtonGroup、QHGroupBox和QVGroupBox继承。

所有成员函数的列表。

公有成员

• QGroupBox ( QWidget*parent = 0, constchar*name = 0 )
• QGroupBox ( constQString&title, QWidget*parent = 0, constchar*name = 0 )
• QGroupBox ( intstrips, Orientationorientation, QWidget*parent = 0, constchar*name = 0 )
• QGroupBox ( intstrips, Orientationorientation, constQString&title, QWidget*parent = 0, constchar*name = 0 )
• virtual void setColumnLayout ( intstrips, Orientationdirection )
• QString title () const
• virtual void setTitle ( const QString & )
• int alignment () const
• virtual void setAlignment ( int )
• int columns () const
• void setColumns ( int )
• Orientation orientation () const
• void setOrientation ( Orientation )
• int insideMargin () const
• int insideSpacing () const
• void setInsideMargin ( intm )
• void setInsideSpacing ( ints )
• void addSpace ( intsize )

属性

• Alignment alignment- 组合框标题的对齐方式
• int columns- 组合框中的列数或者行数（依赖orientation）
• Orientation orientation- 组合框的当前方向
• QString title- 组合框的标题文本

---

详细描述

QGroupBox窗口部件提供了一个有标题的组合框。

组合框提供一个框架、一个标题和一个键盘快捷键，并且显示在它里面地其它不同窗口部件。标题在上面，键盘快捷键移动键盘焦点到组合框的一个子窗口部件，并且子窗口部件将会排列在这个框架中地一个数组中。

使用它的最简单方式是创建一个为你所想要的列数（或者行数）和方向的组合框，并且然后创建其它窗口部件时，把这个组合框作为父对象。

然而，也可以在构造函数之后改变方向（orientation()）和列数（或者行数，columns()），或者忽略所有自动布局支持并且自己来管理所有的这一切。你也可以通过addSpace()把“空白”添加到组合框中。

QGroupBox也让你设置标题（title()，通常在构造函数中设置）和标题对齐方式（alignment()）。

你可以通过setInsideMargin()和setInsideSpacing()改变组合框所用的空白。

也可以参考QButtonGroup、窗口部件外观和风格、布局管理和组织者。

---

成员函数文档

QGroupBox::QGroupBox ( QWidget*parent = 0, constchar*name = 0 )

构造一个没有标题的组合框。

parent和name参数被传递给QWidget构造函数。

这个构造函数不做自动布局。

QGroupBox::QGroupBox ( constQString&title, QWidget*parent = 0, constchar*name = 0 )

构造一个标题为title的组合框。

parent和name参数被传递给QWidget构造函数。

这个构造函数不做自动布局。

QGroupBox::QGroupBox ( intstrips, Orientationorientation, QWidget*parent = 0, constchar*name = 0 )

构造一个没有标题的组合框。子窗口部件会被排列在strips列或者行中（依赖orientation）。

parent和name参数被传递给QWidget构造函数。

QGroupBox::QGroupBox ( intstrips, Orientationorientation, constQString&title, QWidget*parent = 0, constchar*name = 0 )

构造一个标题为title的组合框。子窗口部件会被排列在strips列或者行中（依赖orientation）。

parent和name参数被传递给QWidget构造函数。

void QGroupBox::addSpace ( intsize )

在下一个的自由位置添加一个空白单元格。如果size大于0，空白单元格就有固定的高度或宽度。如果组合框是水平方向，这个空白单元格就有固定的高度，如果组合框是垂直方向，这个空白单元格就有固定的宽度。

使用这个方法来分隔组合框中的窗口部件或者来略过下一个自由单元格。由于性能的原因，请在调用setColumnLayout()或者改变QGroupBox::columns或QGroupBox::orientation属性之后，调用这个方法。首先调用这些方法（如果需要的话）通常是一个不错的主意，并且在这之后插入窗口部件和间隔。

int QGroupBox::alignment () const

返回组合框标题的对齐方式。详细情况请参考“alignment”属性。

int QGroupBox::columns () const

返回组合框中的列数或者行数（依赖orientation）。详细情况请参考“columns”属性。

int QGroupBox::insideMargin () const

返回组合框中的项和框架之间的空白的宽度。

仅仅适用于组合框有一个定义的方向。

默认大约为11。

也可以参考setInsideMargin()和orientation。

int QGroupBox::insideSpacing () const

返回组合框中各项之间的空白的宽度。

仅仅适用于组合框有一个定义的方向。

默认大约为5。

也可以参考setInsideSpacing()和orientation。

Orientation QGroupBox::orientation () const

返回组合框的当前方向。详细情况请参考“orientation”属性。

void QGroupBox::setAlignment ( int ) [虚]

设置组合框标题的对齐方式。详细情况请参考“alignment”属性。

void QGroupBox::setColumnLayout ( intstrips, Orientationdirection ) [虚]

改变组合框的布局。这个函数只有和没有使用任何布局信息的默认构造函数联合使用才有用。这个函数会把所有已经存在的子对象放入新的布局中。在已经插入子对象之后再调用这个函数不是很好的Qt编程风格。

也可以参考orientation和columns。

实例：chart/optionsform.cpp。

void QGroupBox::setColumns ( int )

设置组合框中的列数或者行数（依赖orientation）。详细情况请参考“columns”属性。

void QGroupBox::setInsideMargin ( intm )

设置组合框中的项和框架之间的空白的宽度为m象素。

也可以参考insideSpacing()。

void QGroupBox::setInsideSpacing ( ints )

设置组合框中各项之间的空白的宽度为m象素。

void QGroupBox::setOrientation ( Orientation )

设置组合框的当前方向。详细情况请参考“orientation”属性。

void QGroupBox::setTitle ( constQString& ) [虚]

设置组合框的标题文本。详细情况请参考“title”属性。

QString QGroupBox::title () const

返回组合框的标题文本。详细情况请参考“title”属性。

---

属性文档

Alignment alignment

这个属性保存的是组合框标题的对齐方式。

标题总是被放在框架上面的那行中，可是，水平对齐方式可以由这个对齐参数指定。

对齐方式是下述标记之一：

• AlignAuto根据语言对齐标题，通常为左。
• AlignLeft左对齐标题。
• AlignRight右对齐标题。
• AlignHCenter中间对齐标题。

默认的对齐方式是AlignAuto。

也可以参考Qt::AlignmentFlags。

通过setAlignment()设置属性值并且通过alignment()来获得属性值。

int columns

这个属性保存的是组合框中的列数或者行数（依赖orientation）。

通常设置这个属性不是一个好主意，因为这会使它变慢（它是一个完全的布局）。最好在构造函数中直接设置列数或者行数。

通过setColumns()设置属性值并且通过columns()来获得属性值。

Orientation orientation

这个属性保存的是组合框的当前方向。

水平组合框把它的子对象按列排列，而垂直组合框会按行排列它们。因此只有一列的水平组合框会把它的子对象垂直地排列在这列中。

通常设置这个属性不是一个好主意，因为这会使它变慢（它是一个完全的布局）。最好在构造函数中直接设置方向。

通过setOrientation()设置属性值并且通过orientation()来获得属性值。

QString title

这个属性保存的是组合框的标题文本。

如果这个标题包含一个&，后面还有一个字母，这个组合框标题文本将会又一个焦点改变键盘快捷键。

      g->setTitle( "&User information" );
  

这将会产生“User information”并且U下面有下划线。Alt+U会移动键盘焦点到这个组合框。

没有默认标题文本。

通过setTitle()设置属性值并且通过title()来获得属性值。