QGroupBox(3qt)QGroupBox(3qt)NAME
QGroupBox - Group box frame with a title
#include <qgroupbox.h>
Inherits QFrame.
Inherited by QButtonGroup, QHGroupBox and QVGroupBox.
Public Members
QGroupBox ( QWidget * parent=0, const char * name=0 )
QGroupBox ( const QString & title, QWidget * parent=0,
const char * name=0 )
QGroupBox ( int columns, Orientation o, QWidget *
parent=0, const char * name=0 )
QGroupBox ( int columns, Orientation o, const QString &
title, QWidget * parent=0, const char * name=0 )
virtual void setColumnLayout ( int columns, Orientation o
)
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 )
void addSpace ( int )
Properties
Type Name READ WRITE Options
----------------------------------------------------------------------------
QString title title setTitle
Alignment alignment alignment setAlignment
Orientation orientation orientation setOrientation DESIGNABLE false
int columns columns setColumns
DESCRIPTION
The QGroupBox widget provides a group box frame with a
title.
A group box provides a frame, a title and a keyboard
shortcut, and displays various other widgets inside
itself. The title is on top, the keyboard shortcut moves
keyboard focus to one of the group box' child widgets, and
the child widgets are arranged in an array inside the
frame.
The simplest way to use it is to create a group box with
the desired number of columns and orientation, and then
just create widgets with the group box as parent.
Trolltech AS 13 June 2001 1
QGroupBox(3qt)QGroupBox(3qt)
However, it is also possible to change the orientation()
and number of columns() after construction, or to ignore
all the automatic layout support and manage all that
yourself.
QGroupBox also lets you set the title() (normally set in
the constructor) and if you so please, even the title's
alignment().
[Image Omitted]
See also QButtonGroup.
MEMBER FUNCTION DOCUMENTATIONQGroupBox::QGroupBox ( QWidget * parent=0, const char * name=0 )
Constructs a group box widget with no title.
The parent and name arguments are passed to the QWidget
constructor.
This constructor does not do automatic layout.
QGroupBox::QGroupBox ( const QString & title, QWidget * parent=0,
const char * name=0 )
Constructs a group box with a title.
The parent and name arguments are passed to the QWidget
constructor.
This constructor does not do automatic layout.
QGroupBox::QGroupBox ( int strips, Orientation orientation,
QWidget * parent=0, const char * name=0 )
Constructs a group box with no title. Child widgets will
be arranged in strips rows or columns (depending on
orientation).
The parent and name arguments are passed to the QWidget
constructor.
QGroupBox::QGroupBox ( int strips, Orientation orientation, const
QString & title, QWidget * parent=0, const char * name=0 )
Constructs a group box titled title. Child widgets will be
arranged in strips rows or columns (depending on
orientation).
The parent and name arguments are passed to the QWidget
constructor.
void QGroupBox::addSpace ( int size )
Adds an empty cell at the next free position. If size is
greater than 0 then the empty cell has a fixed height or
width. If the groupbox is oriented horizontally then the
empty cell has a fixed height and if oriented vertically
Trolltech AS 13 June 2001 2
QGroupBox(3qt)QGroupBox(3qt)
it has a fixed width.
Use this method to separate the widgets in the groupbox or
to skip the next free cell. For performance reasons call
this method after calling setColumnLayout(), setColumns()
or setOrientation(). It is in general a good idea to call
these methods first (if needed at all) and insert the
widgets and spaces afterwards.
int QGroupBox::alignment () const
Returns the alignment of the group box title.
The default alignment is AlignLeft.
See also setAlignment() and Qt::AlignmentFlags.
void QGroupBox::childEvent ( QChildEvent * c ) [virtual
protected]
Reimplemented for internal reasons; the API is not
affected.
Reimplemented from QObject.
int QGroupBox::columns () const
Returns the numbers of columns in the groupbox as passed
to the constructor, setColumns() or setColumnLayout().
bool QGroupBox::event ( QEvent * e ) [virtual protected]
Reimplemented for internal reasons; the API is not
affected.
Reimplemented from QObject.
void QGroupBox::focusInEvent ( QFocusEvent * ) [virtual
protected]
Reimplemented for internal reasons; the API is not
affected.
Reimplemented from QWidget.
void QGroupBox::fontChange ( const QFont & oldFont ) [virtual
protected]
Reimplemented for internal reasons; the API is not
affected.
Reimplemented from QWidget.
Orientation QGroupBox::orientation () const
Returns the current orientation of the groupbox.
See also setOrientation().
void QGroupBox::paintEvent ( QPaintEvent * event ) [virtual
protected]
Trolltech AS 13 June 2001 3
QGroupBox(3qt)QGroupBox(3qt)
Reimplemented for internal reasons; the API is not
affected.
Reimplemented from QWidget.
void QGroupBox::resizeEvent ( QResizeEvent * e ) [virtual
protected]
Reimplemented for internal reasons; the API is not
affected.
Reimplemented from QWidget.
void QGroupBox::setAlignment ( int alignment ) [virtual]
Sets the alignment of the group box title.
The title is always placed on the upper frame line,
however, the horizontal alignment can be specified by the
alignment parameter.
The alignment is one of the following flags:
AlignLeft aligns the title text to the left.
AlignRight aligns the title text to the right.
AlignHCenter aligns the title text centered.
See also alignment() and Qt::AlignmentFlags.
void QGroupBox::setColumnLayout ( int columns, Orientation
direction ) [virtual]
Changes the layout of the group box. This function is only
useful in combination with the default constructor that
does not take any layout information. This function will
put all existing children in the new layout. Nevertheless
is is not good programming style to call this function
after children have been inserted.
See also setOrientation() and setColumns().
void QGroupBox::setColumns ( int c )
Changes the numbers of columns to c. Usually it is no good
idea to use the method since it is slow (it does a
complete layout). Better set the numbers of columns
directly in the constructor.
See also column() and setColumnLayout().
void QGroupBox::setOrientation ( Qt::Orientation o )
Changes the orientation of the groupbox. Usually it is no
good idea to use the method since it is slow (it does a
complete layout). Better set the orientation directly in
the constructor.
Trolltech AS 13 June 2001 4
QGroupBox(3qt)QGroupBox(3qt)
See also orientation().
void QGroupBox::setTitle ( const QString & title ) [virtual]
Sets the group box title text to title, and add a focus-
change accelerator if the title contains & followed by an
appropriate letter. This produces "User information" with
the U underscored and Alt-U moves the keyboard focus into
the group:
g->setTitle( "&User information" );
QSize QGroupBox::sizeHint () const [virtual]
Reimplemented for internal reasons; the API is not
affected.
Reimplemented from QWidget.
QString QGroupBox::title () const
Returns the group box title text.
void QGroupBox::updateMask () [virtual protected]
Reimplemented for internal reasons; the API is not
affected.
Reimplemented from QWidget.
SEE ALSO
http://doc.trolltech.com/qgroupbox.html
http://www.trolltech.com/faq/tech.html
COPYRIGHT
Copyright 1992-2001 Trolltech AS,
http://www.trolltech.com. See the license file included
in the distribution for a complete license statement.
AUTHOR
Generated automatically from the source code.
BUGS
If you find a bug in Qt, please report it as described in
http://doc.trolltech.com/bughowto.html. Good bug reports
make our job much simpler. Thank you.
In case of content or formattting problems with this
manual page, please report them to qt-bugs@trolltech.com.
Please include the name of the manual page (qgroupbox.3qt)
and the Qt version (2.3.1).
Trolltech AS 13 June 2001 5
