主页 | 所有的类 | 主要的类 | 注释的类 | 分组的类 | 函数

QGroupBox类参考

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

#include <qgroupbox.h>

继承了QFrame。

被QButtonGroup、QHGroupBox和QVGroupBox继承。

所有成员函数的列表。

公有成员

• QGroupBox ( QWidget * parent = 0, const char * name = 0 )
• QGroupBox ( const QString & title, QWidget * parent = 0, const char * name = 0 )
• QGroupBox ( int strips, Orientation orientation, QWidget * parent = 0, const char * name = 0 )
• QGroupBox ( int strips, Orientation orientation, const QString & title, QWidget * parent = 0, const char * name = 0 )
• virtual void setColumnLayout ( int strips, Orientation direction )
• 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 ( int m )
• void setInsideSpacing ( int s )
• void addSpace ( int size )

属性

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

详细描述

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

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

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

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

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

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

成员函数文档

QGroupBox::QGroupBox ( QWidget * parent = 0, const char * name = 0 )

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

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

QGroupBox::QGroupBox ( const QString & title, QWidget * parent = 0, const char * name = 0 )

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

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

QGroupBox::QGroupBox ( int strips, Orientation orientation, QWidget * parent = 0, const char * name = 0 )

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

QGroupBox::QGroupBox ( int strips, Orientation orientation, const QString & title, QWidget * parent = 0, const char * name = 0 )

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

void QGroupBox::addSpace ( int size )

使用这个方法来分隔组合框中的窗口部件或者来略过下一个自由单元格。由于性能的原因，请在调用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 ( int strips, Orientation direction ) [虚]

也可以参考orientation和columns。

实例：chart/optionsform.cpp。

void QGroupBox::setColumns ( int )

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

void QGroupBox::setInsideMargin ( int m )

也可以参考insideSpacing()。

void QGroupBox::setInsideSpacing ( int s )

void QGroupBox::setOrientation ( Orientation )

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

void QGroupBox::setTitle ( const QString & ) [虚]

设置组合框的标题文本。详细情况请参考“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" );
  

没有默认标题文本。

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

这个文件是Qt工具包一部分。 版权所有 © 1995-2002 Trolltech。保留所有权利。