TDE
/
experimental
mirror of https://mirror.git.trinitydesktop.org/gitea/TDE/experimental
0
0
Fork 0
Code Issues Releases Wiki Activity
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
r14.0.x
master
r14.0.7
r14.0.6
r14.0.5
r14.0.4
r14.0.3
r14.0.2
r14.0.1
r14.0.0
v3.5.13
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '2bde5a3710'
${ noResults }
experimental/tqtinterface/qt4/src/kernel/tqlayout.cpp

4057 lines
112 KiB
C++
Raw Blame History

/****************************************************************************
**
** Implementation of tqlayout classes
**
** Created : 960416
**
** Copyright (C) 2010 Timothy Pearson and (C) 1992-2008 Trolltech ASA.
**
** This file is part of the kernel module of the TQt GUI Toolkit.
**
** This file may be used under the terms of the GNU General
** Public License versions 2.0 or 3.0 as published by the Free
** Software Foundation and appearing in the files LICENSE.GPL2
** and LICENSE.GPL3 included in the packaging of this file.
** Alternatively you may (at your option) use any later version
** of the GNU General Public License if such license has been
** publicly approved by Trolltech ASA (or its successors, if any)
** and the KDE Free TQt Foundation.
**
** Please review the following information to ensure GNU General
** Public Licensing requirements will be met:
** http://trolltech.com/products/qt/licenses/licensing/opensource/.
** If you are unsure which license is appropriate for your use, please
** review the following information:
** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
** or contact the sales department at sales@trolltech.com.
**
** This file may be used under the terms of the Q Public License as
** defined by Trolltech ASA and appearing in the file LICENSE.TQPL
** included in the packaging of this file. Licensees holding valid TQt
** Commercial licenses may use this file in accordance with the TQt
** Commercial License Agreement provided with the Software.
**
** This file is provided "AS IS" with NO WARRANTY OF ANY KIND,
** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted
** herein.
**
**********************************************************************/
#include "tqlayout.h"
#ifndef TQT_NO_LAYOUT
#include "tqapplication.h"
#include "tqwidget.h"
#include "tqmenubar.h"
#include "tqptrlist.h"
#include "tqsizepolicy.h"
#include "tqlayoutengine_p.h"
#ifdef USE_QT4
int menuBarHeightForWidth( QWidget *menubar_w, int w )
{
#ifndef TQT_NO_MENUBAR
TQMenuBar *menubar = static_cast<TQMenuBar*>(TQT_TQWIDGET(menubar_w));
if ( menubar && !menubar->isHidden() && !menubar->isTopLevel() )
return menubar->heightForWidth( TQMAX(w, menubar->minimumWidth()) );
else
#endif
return 0;
}
TQLayout::TQLayout( QWidget *tqparent, int margin, int spacing, const char *name ) : QLayout( tqparent ), autoNewChild(false)
{
setObjectName(QString::fromAscii(name));
setMargin(margin);
if (spacing < 0)
setSpacing(margin);
else
setSpacing(spacing);
if ( tqparent ) tqparent->installEventFilter( this );
TQT_TQOBJECT_REQUIRED_INITIALIZATION(tqparent)
}
TQLayout::TQLayout( QLayout *parentLayout, int spacing, const char *name ) : QLayout(), autoNewChild(false)
{
setObjectName(QString::fromAscii(name));
setSpacing(spacing);
if ( parentLayout ) parentLayout->addItem(this);
if ( parentLayout ) parentLayout->installEventFilter( this );
TQT_TQOBJECT_REQUIRED_INITIALIZATION(parentLayout)
}
TQLayout::TQLayout( int spacing, const char *name ) : QLayout(), autoNewChild(false)
{
setObjectName(QString::fromAscii(name));
setSpacing(spacing);
}
TQ_SPExpandData TQLayout::expandingDirections() const {
return (Qt::Orientations)TQSizePolicy::BothDirections;
}
TQLayout *TQLayout::tqlayout() {
return this;
}
TQSize TQLayout::sizeHint() const {
return sizeHint();
}
TQSize TQLayout::tqminimumSize() const {
return QLayout::minimumSize();
}
TQSize TQLayout::tqmaximumSize() const {
return QLayout::maximumSize();
}
TQWidget *TQLayout::mainWidget() {
return TQT_TQWIDGET(parentWidget());
}
void TQLayout::tqinvalidate() {
QLayout::invalidate();
}
void TQLayout::invalidate() {
tqinvalidate();
}
TQRect TQLayout::tqgeometry() const {
return QLayout::geometry();
}
const char *TQLayout::tqname() const {
if (dynamic_cast<const TQLayout*>(static_cast<const QLayout*>(static_cast<const QObject*>(this)))) {
static_object_name = TQT_OBJECT_NAME_HANDLER(objectName());
return static_object_name.ascii();
}
else {
printf("[WARNING] Attempted to call TQLayout::tqname() on an object without a constructed TQLayout object or base object. Returning \"\"\n\r");
return "";
}
}
const char *TQLayout::name() const {
if (dynamic_cast<const TQLayout*>(static_cast<const QLayout*>(static_cast<const QObject*>(this)))) {
static_object_name = TQT_OBJECT_NAME_HANDLER(objectName());
return static_object_name.ascii();
}
else {
printf("[WARNING] Attempted to call TQLayout::tqname() on an object without a constructed TQLayout object or base object. Returning \"\"\n\r");
return "";
}
}
int TQLayout::tqalignment() const {
return alignment();
}
TQWidget *TQLayout::mainWidget() const {
return TQT_TQWIDGET(parentWidget());
}
void TQLayout::remove(QWidget *w) {
removeWidget(w);
}
void TQLayout::add(QWidget *w) {
addWidget(w);
}
void TQLayout::setResizeMode(SizeConstraint s) {
setSizeConstraint(s);
}
void TQLayout::setResizeMode(ResizeMode s) {
setResizeMode((SizeConstraint)s);
}
TQLayout::SizeConstraint TQLayout::resizeMode() const {
return sizeConstraint();
}
TQLayout::ResizeMode TQLayout::tqresizeMode() const {
return (ResizeMode)sizeConstraint();
}
void TQLayout::setAutoAdd(bool a) {
autoNewChild = a;
}
bool TQLayout::autoAdd() const {
return autoNewChild;
}
void TQLayout::tqsetAlignment( int a ) {
return setAlignment((Qt::Alignment)a);
}
// Qt4 handler interface
bool TQLayout::eventFilter( QObject *q, QEvent *e ) {
return eventFilter(static_cast<TQObject*>(q), static_cast<TQEvent*>(e));
}
bool TQLayout::event( QEvent *e ) {
return event(static_cast<TQEvent*>(e));
}
void TQLayout::timerEvent(QTimerEvent *e) {
timerEvent(static_cast<TQTimerEvent*>(e));
}
void TQLayout::childEvent(QChildEvent *e) {
TQT_TQOBJECT_CHILDEVENT_CONDITIONAL childEvent(static_cast<TQChildEvent*>(e));
}
void TQLayout::customEvent(QEvent *e) {
customEvent(static_cast<TQCustomEvent*>(e));
}
bool TQLayout::eventFilter( TQObject *o, TQEvent *e ) {
TQ_UNUSED(o);
if (e->type() == TQEvent::Resize) {
activate();
TQResizeEvent *r = (TQResizeEvent *)e;
int mbh = 0;
#ifndef TQT_NO_MENUBAR
mbh = menuBarHeightForWidth( menuBar(), r->size().width() );
#endif
// int b = marginImpl ? 0 : outsideBorder;
int b = 0;
setGeometry( TQRect( b, mbh + b, r->size().width() - 2 * b, r->size().height() - mbh - 2 * b ) );
}
else if (e->type() == TQEvent::ChildInserted) {
if (autoNewChild) {
QChildEvent *c = (QChildEvent *)e;
if (c->child()->isWidgetType()) {
QWidget *w = (QWidget *)c->child();
if (!w->isWindow()) {
// #if !defined(QT_NO_MENUBAR) && !defined(QT_NO_TOOLBAR)
// if (qobject_cast<QMenuBar*>(w) && !qobject_cast<QToolBar*>(w->parentWidget())) {
// setMenuBar( (QMenuBar *)w );
// invalidate();
// } else
// #endif
// #ifndef QT_NO_SIZEGRIP
// if (qobject_cast<QSizeGrip*>(w) ) {
// //SizeGrip is handled by the dialog itself.
// } else
// #endif
// addItem(QLayoutPrivate::createWidgetItem(this, w));
addWidget(w);
}
}
}
}
else if (e->type() == TQEvent::LayoutHint) {
// d->d = false;
// if (parent()) {
// if (static_cast<QWidget *>(parent())->isVisible()) {
activate();
// }
// }
}
// return FALSE;
return QLayout::eventFilter( o, e );
// return TQObject::eventFilter( o, e );
}
TQLayoutIterator TQLayout::iterator() {
return TQLayoutIterator(this,true);
}
/*!
\compat
Sets this layout's parent widget to a fixed size with width \a w
and height \a h, stopping the user from resizing it, and also
prevents the layout from resizing it, even if the layout's size
hint should change. Does nothing if this is not a top-level
layout (i.e., if parent()->isWidgetType()).
As a special case, if both \a w and \a h are 0, then the layout's
current sizeHint() is used.
Use \c setResizeMode(Fixed) to stop the widget from being resized
by the user, while still allowing the layout to resize it when
the sizeHint() changes.
Use \c setResizeMode(FreeResize) to allow the user to resize the
widget, while preventing the layout from resizing it.
*/
void TQLayout::freeze(int w, int h)
{
// if (!isTopLevel())
// return;
if (w <= 0 || h <= 0) {
QSize s = totalSizeHint();
w = s.width();
h = s.height();
}
setSizeConstraint(SetNoConstraint); // layout will not change min/max size
QWidget *parent = parentWidget();
if (parent)
parent->setFixedSize(w, h);
}
// Use the TQt virtual functions, not the built in Qt ones...
// This requires that the base virtual Qt functions be reimplemented so as to point to the TQt virtual functions instead as shown below.
// This way, when Trinity overrides a TQt virtual function, the calling Qt code will blithely use the overriden TQt function instead.
QLayout *TQLayout::layout() {
return tqlayout();
}
void TQLayout::setGeometry(const TQRect &r) {
return QLayout::setGeometry(r);
}
TQRect TQLayout::alignmentRect( const TQRect& qr ) const {
return alignmentRect(qr);
}
void TQLayout::tqt_handle_qt_destroyed(QObject* obj) {
emit destroyed(TQT_TQOBJECT(obj));
}
TQLayoutIterator::TQLayoutIterator(QLayout *i) : layout(static_cast<TQLayout*>(i)), index(0) {
}
TQLayoutIterator::TQLayoutIterator(QLayout *i, bool) : layout(static_cast<TQLayout*>(i)), index(0) {
}
TQLayoutItem *TQLayoutIterator::operator++() {
return static_cast<TQLayoutItem*>(layout->itemAt(++index));
}
TQLayoutItem *TQLayoutIterator::current() {
return static_cast<TQLayoutItem*>(layout->itemAt(index));
}
TQLayoutItem *TQLayoutIterator::takeCurrent() {
return static_cast<TQLayoutItem*>(layout->takeAt(index));
}
void TQLayoutIterator::deleteCurrent() {
delete layout->takeAt(index);
}
TQSpacerItem *TQLayoutItem::tqspacerItem()
{
return static_cast<TQSpacerItem*>(QLayoutItem::spacerItem());
}
/*!
This virtual function receives events to an object and should
return TRUE if the event \a e was recognized and processed.
The event() function can be reimplemented to customize the
behavior of an object.
\sa installEventFilter(), timerEvent(), TQApplication::sendEvent(),
TQApplication::postEvent(), TQWidget::event()
*/
bool TQLayout::event( TQEvent *e )
{
#if defined(TQT_CHECK_NULL)
if ( e == 0 )
qWarning( "TQLayout::event: Null events are not permitted" );
#endif
// if ( eventFilters ) { // try filters
// if ( activate_filters(e) ) // stopped by a filter
// return TRUE;
// }
//
switch ( e->type() ) {
// case TQEvent::Timer:
// timerEvent( (TQTimerEvent*)e );
// return TRUE;
//
// case TQEvent::DeferredDelete:
// delete this;
// return TRUE;
//
// default:
// if ( e->type() >= TQEvent::User ) {
// customEvent( (TQCustomEvent*) e );
// return TRUE;
// }
// break;
// }
case TQEvent::ChildInserted:
// case TQEvent::ChildRemoved: // Causes a recursion loop if uncommented
childEvent( (TQChildEvent*)e );
return TRUE;
default:
return QLayout::event(e);
}
return FALSE;
}
#if 0
void TQGridLayout::tqsetAlignment( int a )
{
setAlignment((Qt::AlignmentFlag)a);
}
#endif
#if 0
// NOTE
// The following functions are cloned from TQWidget
// They are only required for TQLayout and TQGridLayout becase those classes do not inherit TQObject or TQWidget
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive mouse move events for the widget.
If mouse tracking is switched off, mouse move events only occur if
a mouse button is pressed while the mouse is being moved. If mouse
tracking is switched on, mouse move events occur even if no mouse
button is pressed.
TQMouseEvent::pos() reports the position of the mouse cursor,
relative to this widget. For press and release events, the
position is usually the same as the position of the last mouse
move event, but it might be different if the user's hand shakes.
This is a feature of the underlying window system, not TQt.
\sa setMouseTracking(), mousePressEvent(), mouseReleaseEvent(),
mouseDoubleClickEvent(), event(), TQMouseEvent
*/
void TQLayout::mouseMoveEvent( TQMouseEvent * e)
{
e->ignore();
}
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive mouse press events for the widget.
If you create new widgets in the mousePressEvent() the
mouseReleaseEvent() may not end up where you expect, depending on
the underlying window system (or X11 window manager), the widgets'
location and maybe more.
The default implementation implements the closing of popup widgets
when you click outside the window. For other widget types it does
nothing.
\sa mouseReleaseEvent(), mouseDoubleClickEvent(),
mouseMoveEvent(), event(), TQMouseEvent
*/
void TQLayout::mousePressEvent( TQMouseEvent * )
{
// TQT_TQWIDGET_CONST(this)->mousePressEvent(e);
}
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive mouse release events for the widget.
\sa mouseReleaseEvent(), mouseDoubleClickEvent(),
mouseMoveEvent(), event(), TQMouseEvent
*/
void TQLayout::mouseReleaseEvent( TQMouseEvent * e )
{
e->ignore();
}
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive mouse double click events for the widget.
The default implementation generates a normal mouse press event.
Note that the widgets gets a mousePressEvent() and a
mouseReleaseEvent() before the mouseDoubleClickEvent().
\sa mousePressEvent(), mouseReleaseEvent() mouseMoveEvent(),
event(), TQMouseEvent
*/
void TQLayout::mouseDoubleClickEvent( TQMouseEvent *e )
{
mousePressEvent( e ); // try mouse press event
}
#ifndef TQT_NO_WHEELEVENT
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive wheel events for the widget.
If you reimplement this handler, it is very important that you
\link TQWheelEvent ignore()\endlink the event if you do not handle
it, so that the widget's tqparent can interpret it.
The default implementation ignores the event.
\sa TQWheelEvent::ignore(), TQWheelEvent::accept(), event(),
TQWheelEvent
*/
void TQLayout::wheelEvent( TQWheelEvent *e )
{
e->ignore();
}
#endif
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive tablet events for the widget.
If you reimplement this handler, it is very important that you
\link TQTabletEvent ignore()\endlink the event if you do not handle
it, so that the widget's tqparent can interpret it.
The default implementation ignores the event.
\sa TQTabletEvent::ignore(), TQTabletEvent::accept(), event(),
TQTabletEvent
*/
void TQLayout::tabletEvent( TQTabletEvent *e )
{
e->ignore();
}
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive key press events for the widget.
A widget must call setFocusPolicy() to accept focus initially and
have focus in order to receive a key press event.
If you reimplement this handler, it is very important that you
explicitly \link TQKeyEvent::ignore() ignore\endlink the event
if you do not understand it, so that the widget's tqparent can
interpret it; otherwise, the event will be implicitly accepted.
Although top-level widgets are able to choose whether to accept
or ignore unknown events because they have no tqparent widgets that
could otherwise handle them, it is good practice to explicitly
ignore events to make widgets as reusable as possible.
The default implementation closes popup widgets if the user
presses <b>Esc</b>. Otherwise the event is ignored.
\sa keyReleaseEvent(), TQKeyEvent::ignore(), setFocusPolicy(),
focusInEvent(), focusOutEvent(), event(), TQKeyEvent
*/
void TQLayout::keyPressEvent( TQKeyEvent * )
{
// TQT_TQWIDGET_CONST(this)->keyPressEvent(e);
}
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive key release events for the widget.
A widget must \link setFocusPolicy() accept focus\endlink
initially and \link hasFocus() have focus\endlink in order to
receive a key release event.
If you reimplement this handler, it is very important that you
\link TQKeyEvent ignore()\endlink the release if you do not
understand it, so that the widget's tqparent can interpret it.
The default implementation ignores the event.
\sa keyPressEvent(), TQKeyEvent::ignore(), setFocusPolicy(),
focusInEvent(), focusOutEvent(), event(), TQKeyEvent
*/
void TQLayout::keyReleaseEvent( TQKeyEvent *e )
{
e->ignore();
}
/*!
This event handler can be reimplemented in a subclass to receive
keyboard focus events (focus received) for the widget.
A widget normally must setFocusPolicy() to something other than
\c NoFocus in order to receive focus events. (Note that the
application programmer can call setFocus() on any widget, even
those that do not normally accept focus.)
The default implementation updates the widget (except for toplevel
widgets that do not specify a focusPolicy() ). It also calls
setMicroFocusHint(), hinting any system-specific input tools about
the focus of the user's attention.
\sa focusOutEvent(), setFocusPolicy(), keyPressEvent(),
keyReleaseEvent(), event(), TQFocusEvent
*/
void TQLayout::focusInEvent( TQFocusEvent * )
{
// TQT_TQWIDGET_CONST(this)->focusInEvent(e);
}
/*!
This event handler can be reimplemented in a subclass to receive
keyboard focus events (focus lost) for the widget.
A widget normally must setFocusPolicy() to something other than
\c NoFocus in order to receive focus events. (Note that the
application programmer can call setFocus() on any widget, even
those that do not normally accept focus.)
The default implementation updates the widget (except for toplevel
widgets that do not specify a focusPolicy() ). It also calls
setMicroFocusHint(), hinting any system-specific input tools about
the focus of the user's attention.
\sa focusInEvent(), setFocusPolicy(), keyPressEvent(),
keyReleaseEvent(), event(), TQFocusEvent
*/
void TQLayout::focusOutEvent( TQFocusEvent * )
{
// TQT_TQWIDGET_CONST(this)->focusOutEvent(e);
}
/*!
This event handler can be reimplemented in a subclass to receive
widget enter events.
An event is sent to the widget when the mouse cursor enters the
widget.
\sa leaveEvent(), mouseMoveEvent(), event()
*/
void TQLayout::enterEvent( TQEvent * )
{
}
/*!
This event handler can be reimplemented in a subclass to receive
widget leave events.
A leave event is sent to the widget when the mouse cursor leaves
the widget.
\sa enterEvent(), mouseMoveEvent(), event()
*/
void TQLayout::leaveEvent( TQEvent * )
{
}
/*!
This event handler can be reimplemented in a subclass to receive
paint events.
A paint event is a request to tqrepaint all or part of the widget.
It can happen as a result of tqrepaint() or update(), or because the
widget was obscured and has now been uncovered, or for many other
reasons.
Many widgets can simply tqrepaint their entire surface when asked
to, but some slow widgets need to optimize by painting only the
requested region: TQPaintEvent::region(). This speed optimization
does not change the result, as painting is clipped to that region
during event processing. TQListView and TQCanvas do this, for
example.
TQt also tries to speed up painting by merging multiple paint
events into one. When update() is called several times or the
window system sends several paint events, TQt merges these events
into one event with a larger region (see TQRegion::unite()).
tqrepaint() does not permit this optimization, so we suggest using
update() when possible.
When the paint event occurs, the update region has normally been
erased, so that you're painting on the widget's background. There
are a couple of exceptions and TQPaintEvent::erased() tells you
whether the widget has been erased or not.
The background can be set using setBackgroundMode(),
setPaletteBackgroundColor() or setBackgroundPixmap(). The
documentation for setBackgroundMode() elaborates on the
background; we recommend reading it.
\sa event(), tqrepaint(), update(), TQPainter, TQPixmap, TQPaintEvent
*/
void TQLayout::paintEvent( TQPaintEvent *e )
{
}
/*!
This event handler can be reimplemented in a subclass to receive
widget move events. When the widget receives this event, it is
already at the new position.
The old position is accessible through TQMoveEvent::oldPos().
\sa resizeEvent(), event(), move(), TQMoveEvent
*/
void TQLayout::moveEvent( TQMoveEvent * )
{
}
/*!
This event handler can be reimplemented in a subclass to receive
widget resize events. When resizeEvent() is called, the widget
already has its new tqgeometry. The old size is accessible through
TQResizeEvent::oldSize().
The widget will be erased and receive a paint event immediately
after processing the resize event. No drawing need be (or should
be) done inside this handler.
Widgets that have been created with the \c WNoAutoErase flag
will not be erased. Nevertheless, they will receive a paint event
for their entire area afterwards. Again, no drawing needs to be
done inside this handler.
The default implementation calls updateMask() if the widget has
\link TQLayout::setAutoMask() automatic masking\endlink enabled.
\sa moveEvent(), event(), resize(), TQResizeEvent, paintEvent()
*/
void TQLayout::resizeEvent( TQResizeEvent * )
{
}
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive widget close events.
The default implementation calls e->accept(), which hides this
widget. See the \l TQCloseEvent documentation for more details.
\sa event(), hide(), close(), TQCloseEvent
*/
void TQLayout::closeEvent( TQCloseEvent *e )
{
e->accept();
}
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive widget context menu events.
The default implementation calls e->ignore(), which rejects the
context event. See the \l TQContextMenuEvent documentation for
more details.
\sa event(), TQContextMenuEvent
*/
void TQLayout::contextMenuEvent( TQContextMenuEvent *e )
{
e->ignore();
}
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive Input Method composition events. This handler
is called when the user begins entering text using an Input Method.
The default implementation calls e->ignore(), which rejects the
Input Method event. See the \l TQIMEvent documentation for more
details.
\sa event(), TQIMEvent
*/
void TQLayout::imStartEvent( TQIMEvent *e )
{
e->ignore();
}
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive Input Method composition events. This handler
is called when the user has entered some text using an Input Method.
The default implementation calls e->ignore(), which rejects the
Input Method event. See the \l TQIMEvent documentation for more
details.
\sa event(), TQIMEvent
*/
void TQLayout::imComposeEvent( TQIMEvent *e )
{
e->ignore();
}
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive Input Method composition events. This handler
is called when the user has finished inputting text via an Input
Method.
The default implementation calls e->ignore(), which rejects the
Input Method event. See the \l TQIMEvent documentation for more
details.
\sa event(), TQIMEvent
*/
void TQLayout::imEndEvent( TQIMEvent *e )
{
e->ignore();
}
#ifndef TQT_NO_DRAGANDDROP
/*!
This event handler is called when a drag is in progress and the
mouse enters this widget.
See the \link dnd.html Drag-and-drop documentation\endlink for an
overview of how to provide drag-and-drop in your application.
\sa TQTextDrag, TQImageDrag, TQDragEnterEvent
*/
void TQLayout::dragEnterEvent( TQDragEnterEvent * )
{
}
/*!
This event handler is called when a drag is in progress and the
mouse enters this widget, and whenever it moves within the widget.
See the \link dnd.html Drag-and-drop documentation\endlink for an
overview of how to provide drag-and-drop in your application.
\sa TQTextDrag, TQImageDrag, TQDragMoveEvent
*/
void TQLayout::dragMoveEvent( TQDragMoveEvent * )
{
}
/*!
This event handler is called when a drag is in progress and the
mouse leaves this widget.
See the \link dnd.html Drag-and-drop documentation\endlink for an
overview of how to provide drag-and-drop in your application.
\sa TQTextDrag, TQImageDrag, TQDragLeaveEvent
*/
void TQLayout::dragLeaveEvent( TQDragLeaveEvent * )
{
}
/*!
This event handler is called when the drag is dropped on this
widget.
See the \link dnd.html Drag-and-drop documentation\endlink for an
overview of how to provide drag-and-drop in your application.
\sa TQTextDrag, TQImageDrag, TQDropEvent
*/
void TQLayout::dropEvent( TQDropEvent * )
{
}
#endif // TQT_NO_DRAGANDDROP
/*!
This event handler can be reimplemented in a subclass to receive
widget show events.
Non-spontaneous show events are sent to widgets immediately before
they are shown. The spontaneous show events of top-level widgets
are delivered afterwards.
\sa event(), TQShowEvent
*/
void TQLayout::showEvent( TQShowEvent * )
{
}
/*!
This event handler can be reimplemented in a subclass to receive
widget hide events.
Hide events are sent to widgets immediately after they have been
hidden.
\sa event(), TQHideEvent
*/
void TQLayout::hideEvent( TQHideEvent * )
{
}
#endif
void TQLayout::timerEvent( TQTimerEvent * )
{
}
void TQLayout::childEvent( TQChildEvent * )
{
}
void TQLayout::customEvent( TQCustomEvent * )
{
}
#if 0
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive mouse move events for the widget.
If mouse tracking is switched off, mouse move events only occur if
a mouse button is pressed while the mouse is being moved. If mouse
tracking is switched on, mouse move events occur even if no mouse
button is pressed.
TQMouseEvent::pos() reports the position of the mouse cursor,
relative to this widget. For press and release events, the
position is usually the same as the position of the last mouse
move event, but it might be different if the user's hand shakes.
This is a feature of the underlying window system, not TQt.
\sa setMouseTracking(), mousePressEvent(), mouseReleaseEvent(),
mouseDoubleClickEvent(), event(), TQMouseEvent
*/
void TQGridLayout::mouseMoveEvent( TQMouseEvent * e)
{
e->ignore();
}
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive mouse press events for the widget.
If you create new widgets in the mousePressEvent() the
mouseReleaseEvent() may not end up where you expect, depending on
the underlying window system (or X11 window manager), the widgets'
location and maybe more.
The default implementation implements the closing of popup widgets
when you click outside the window. For other widget types it does
nothing.
\sa mouseReleaseEvent(), mouseDoubleClickEvent(),
mouseMoveEvent(), event(), TQMouseEvent
*/
void TQGridLayout::mousePressEvent( TQMouseEvent * )
{
// TQT_TQLAYOUT_CONST(this)->mousePressEvent(e);
}
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive mouse release events for the widget.
\sa mouseReleaseEvent(), mouseDoubleClickEvent(),
mouseMoveEvent(), event(), TQMouseEvent
*/
void TQGridLayout::mouseReleaseEvent( TQMouseEvent * e )
{
e->ignore();
}
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive mouse double click events for the widget.
The default implementation generates a normal mouse press event.
Note that the widgets gets a mousePressEvent() and a
mouseReleaseEvent() before the mouseDoubleClickEvent().
\sa mousePressEvent(), mouseReleaseEvent() mouseMoveEvent(),
event(), TQMouseEvent
*/
void TQGridLayout::mouseDoubleClickEvent( TQMouseEvent *e )
{
mousePressEvent( e ); // try mouse press event
}
#ifndef TQT_NO_WHEELEVENT
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive wheel events for the widget.
If you reimplement this handler, it is very important that you
\link TQWheelEvent ignore()\endlink the event if you do not handle
it, so that the widget's tqparent can interpret it.
The default implementation ignores the event.
\sa TQWheelEvent::ignore(), TQWheelEvent::accept(), event(),
TQWheelEvent
*/
void TQGridLayout::wheelEvent( TQWheelEvent *e )
{
e->ignore();
}
#endif
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive tablet events for the widget.
If you reimplement this handler, it is very important that you
\link TQTabletEvent ignore()\endlink the event if you do not handle
it, so that the widget's tqparent can interpret it.
The default implementation ignores the event.
\sa TQTabletEvent::ignore(), TQTabletEvent::accept(), event(),
TQTabletEvent
*/
void TQGridLayout::tabletEvent( TQTabletEvent *e )
{
e->ignore();
}
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive key press events for the widget.
A widget must call setFocusPolicy() to accept focus initially and
have focus in order to receive a key press event.
If you reimplement this handler, it is very important that you
explicitly \link TQKeyEvent::ignore() ignore\endlink the event
if you do not understand it, so that the widget's tqparent can
interpret it; otherwise, the event will be implicitly accepted.
Although top-level widgets are able to choose whether to accept
or ignore unknown events because they have no tqparent widgets that
could otherwise handle them, it is good practice to explicitly
ignore events to make widgets as reusable as possible.
The default implementation closes popup widgets if the user
presses <b>Esc</b>. Otherwise the event is ignored.
\sa keyReleaseEvent(), TQKeyEvent::ignore(), setFocusPolicy(),
focusInEvent(), focusOutEvent(), event(), TQKeyEvent
*/
void TQGridLayout::keyPressEvent( TQKeyEvent * )
{
// TQT_TQLAYOUT_CONST(this)->keyPressEvent(e);
}
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive key release events for the widget.
A widget must \link setFocusPolicy() accept focus\endlink
initially and \link hasFocus() have focus\endlink in order to
receive a key release event.
If you reimplement this handler, it is very important that you
\link TQKeyEvent ignore()\endlink the release if you do not
understand it, so that the widget's tqparent can interpret it.
The default implementation ignores the event.
\sa keyPressEvent(), TQKeyEvent::ignore(), setFocusPolicy(),
focusInEvent(), focusOutEvent(), event(), TQKeyEvent
*/
void TQGridLayout::keyReleaseEvent( TQKeyEvent *e )
{
e->ignore();
}
/*!
This event handler can be reimplemented in a subclass to receive
keyboard focus events (focus received) for the widget.
A widget normally must setFocusPolicy() to something other than
\c NoFocus in order to receive focus events. (Note that the
application programmer can call setFocus() on any widget, even
those that do not normally accept focus.)
The default implementation updates the widget (except for toplevel
widgets that do not specify a focusPolicy() ). It also calls
setMicroFocusHint(), hinting any system-specific input tools about
the focus of the user's attention.
\sa focusOutEvent(), setFocusPolicy(), keyPressEvent(),
keyReleaseEvent(), event(), TQFocusEvent
*/
void TQGridLayout::focusInEvent( TQFocusEvent * )
{
// TQT_TQLAYOUT_CONST(this)->focusInEvent(e);
}
/*!
This event handler can be reimplemented in a subclass to receive
keyboard focus events (focus lost) for the widget.
A widget normally must setFocusPolicy() to something other than
\c NoFocus in order to receive focus events. (Note that the
application programmer can call setFocus() on any widget, even
those that do not normally accept focus.)
The default implementation updates the widget (except for toplevel
widgets that do not specify a focusPolicy() ). It also calls
setMicroFocusHint(), hinting any system-specific input tools about
the focus of the user's attention.
\sa focusInEvent(), setFocusPolicy(), keyPressEvent(),
keyReleaseEvent(), event(), TQFocusEvent
*/
void TQGridLayout::focusOutEvent( TQFocusEvent * )
{
// TQT_TQLAYOUT_CONST(this)->focusOutEvent(e);
}
/*!
This event handler can be reimplemented in a subclass to receive
widget enter events.
An event is sent to the widget when the mouse cursor enters the
widget.
\sa leaveEvent(), mouseMoveEvent(), event()
*/
void TQGridLayout::enterEvent( TQEvent * )
{
}
/*!
This event handler can be reimplemented in a subclass to receive
widget leave events.
A leave event is sent to the widget when the mouse cursor leaves
the widget.
\sa enterEvent(), mouseMoveEvent(), event()
*/
void TQGridLayout::leaveEvent( TQEvent * )
{
}
/*!
This event handler can be reimplemented in a subclass to receive
paint events.
A paint event is a request to tqrepaint all or part of the widget.
It can happen as a result of tqrepaint() or update(), or because the
widget was obscured and has now been uncovered, or for many other
reasons.
Many widgets can simply tqrepaint their entire surface when asked
to, but some slow widgets need to optimize by painting only the
requested region: TQPaintEvent::region(). This speed optimization
does not change the result, as painting is clipped to that region
during event processing. TQListView and TQCanvas do this, for
example.
TQt also tries to speed up painting by merging multiple paint
events into one. When update() is called several times or the
window system sends several paint events, TQt merges these events
into one event with a larger region (see TQRegion::unite()).
tqrepaint() does not permit this optimization, so we suggest using
update() when possible.
When the paint event occurs, the update region has normally been
erased, so that you're painting on the widget's background. There
are a couple of exceptions and TQPaintEvent::erased() tells you
whether the widget has been erased or not.
The background can be set using setBackgroundMode(),
setPaletteBackgroundColor() or setBackgroundPixmap(). The
documentation for setBackgroundMode() elaborates on the
background; we recommend reading it.
\sa event(), tqrepaint(), update(), TQPainter, TQPixmap, TQPaintEvent
*/
void TQGridLayout::paintEvent( TQPaintEvent *e )
{
// // At least let Qt4 get a shot at painting it
// QWidget::paintEvent(e);
}
/*!
This event handler can be reimplemented in a subclass to receive
widget move events. When the widget receives this event, it is
already at the new position.
The old position is accessible through TQMoveEvent::oldPos().
\sa resizeEvent(), event(), move(), TQMoveEvent
*/
void TQGridLayout::moveEvent( TQMoveEvent * )
{
}
/*!
This event handler can be reimplemented in a subclass to receive
widget resize events. When resizeEvent() is called, the widget
already has its new tqgeometry. The old size is accessible through
TQResizeEvent::oldSize().
The widget will be erased and receive a paint event immediately
after processing the resize event. No drawing need be (or should
be) done inside this handler.
Widgets that have been created with the \c WNoAutoErase flag
will not be erased. Nevertheless, they will receive a paint event
for their entire area afterwards. Again, no drawing needs to be
done inside this handler.
The default implementation calls updateMask() if the widget has
\link TQGridLayout::setAutoMask() automatic masking\endlink enabled.
\sa moveEvent(), event(), resize(), TQResizeEvent, paintEvent()
*/
void TQGridLayout::resizeEvent( TQResizeEvent * )
{
}
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive widget close events.
The default implementation calls e->accept(), which hides this
widget. See the \l TQCloseEvent documentation for more details.
\sa event(), hide(), close(), TQCloseEvent
*/
void TQGridLayout::closeEvent( TQCloseEvent *e )
{
e->accept();
}
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive widget context menu events.
The default implementation calls e->ignore(), which rejects the
context event. See the \l TQContextMenuEvent documentation for
more details.
\sa event(), TQContextMenuEvent
*/
void TQGridLayout::contextMenuEvent( TQContextMenuEvent *e )
{
e->ignore();
}
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive Input Method composition events. This handler
is called when the user begins entering text using an Input Method.
The default implementation calls e->ignore(), which rejects the
Input Method event. See the \l TQIMEvent documentation for more
details.
\sa event(), TQIMEvent
*/
void TQGridLayout::imStartEvent( TQIMEvent *e )
{
e->ignore();
}
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive Input Method composition events. This handler
is called when the user has entered some text using an Input Method.
The default implementation calls e->ignore(), which rejects the
Input Method event. See the \l TQIMEvent documentation for more
details.
\sa event(), TQIMEvent
*/
void TQGridLayout::imComposeEvent( TQIMEvent *e )
{
e->ignore();
}
/*!
This event handler, for event \a e, can be reimplemented in a
subclass to receive Input Method composition events. This handler
is called when the user has finished inputting text via an Input
Method.
The default implementation calls e->ignore(), which rejects the
Input Method event. See the \l TQIMEvent documentation for more
details.
\sa event(), TQIMEvent
*/
void TQGridLayout::imEndEvent( TQIMEvent *e )
{
e->ignore();
}
#ifndef TQT_NO_DRAGANDDROP
/*!
This event handler is called when a drag is in progress and the
mouse enters this widget.
See the \link dnd.html Drag-and-drop documentation\endlink for an
overview of how to provide drag-and-drop in your application.
\sa TQTextDrag, TQImageDrag, TQDragEnterEvent
*/
void TQGridLayout::dragEnterEvent( TQDragEnterEvent * )
{
}
/*!
This event handler is called when a drag is in progress and the
mouse enters this widget, and whenever it moves within the widget.
See the \link dnd.html Drag-and-drop documentation\endlink for an
overview of how to provide drag-and-drop in your application.
\sa TQTextDrag, TQImageDrag, TQDragMoveEvent
*/
void TQGridLayout::dragMoveEvent( TQDragMoveEvent * )
{
}
/*!
This event handler is called when a drag is in progress and the
mouse leaves this widget.
See the \link dnd.html Drag-and-drop documentation\endlink for an
overview of how to provide drag-and-drop in your application.
\sa TQTextDrag, TQImageDrag, TQDragLeaveEvent
*/
void TQGridLayout::dragLeaveEvent( TQDragLeaveEvent * )
{
}
/*!
This event handler is called when the drag is dropped on this
widget.
See the \link dnd.html Drag-and-drop documentation\endlink for an
overview of how to provide drag-and-drop in your application.
\sa TQTextDrag, TQImageDrag, TQDropEvent
*/
void TQGridLayout::dropEvent( TQDropEvent * )
{
}
#endif // TQT_NO_DRAGANDDROP
/*!
This event handler can be reimplemented in a subclass to receive
widget show events.
Non-spontaneous show events are sent to widgets immediately before
they are shown. The spontaneous show events of top-level widgets
are delivered afterwards.
\sa event(), TQShowEvent
*/
void TQGridLayout::showEvent( TQShowEvent * )
{
}
/*!
This event handler can be reimplemented in a subclass to receive
widget hide events.
Hide events are sent to widgets immediately after they have been
hidden.
\sa event(), TQHideEvent
*/
void TQGridLayout::hideEvent( TQHideEvent * )
{
}
void TQGridLayout::timerEvent( TQTimerEvent * )
{
}
void TQGridLayout::childEvent( TQChildEvent * )
{
}
void TQGridLayout::customEvent( TQCustomEvent * )
{
}
#endif
TQMetaObject *TQLayout::tqmetaObject() const {
return TQT_TQOBJECT_CONST(this)->tqmetaObject();
}
#else // USE_QT4
#endif // USE_QT4
/*
Three internal classes related to TQGridLayout: (1) TQGridBox is a
TQLayoutItem with (row, column) information; (2) TQGridMultiBox is a
TQGridBox with (torow, tocolumn) information; (3) TQGridLayoutData is
the internal representation of a TQGridLayout.
*/
class TQGridBox
{
public:
TQGridBox( TQLayoutItem *lit ) { item_ = lit; }
TQGridBox( TQWidget *wid ) { item_ = new TQWidgetItem( wid ); }
TQGridBox( int w, int h, TQSizePolicy::SizeType hData = TQSizePolicy::Minimum,
TQSizePolicy::SizeType vData = TQSizePolicy::Minimum )
{ item_ = TQT_TQLAYOUTITEM(new TQSpacerItem( w, h, hData, vData )); }
~TQGridBox() { delete item_; }
QSize sizeHint() const { return item_->sizeHint(); }
QSize tqminimumSize() const { return item_->minimumSize(); }
QSize tqmaximumSize() const { return item_->maximumSize(); }
TQ_SPExpandData expandingDirections() const { return item_->expandingDirections(); }
bool isEmpty() const { return item_->isEmpty(); }
bool hasHeightForWidth() const { return item_->hasHeightForWidth(); }
int heightForWidth( int w ) const { return item_->heightForWidth(w); }
void tqsetAlignment( int a ) { item_->tqsetAlignment( a ); }
void setGeometry( const TQRect &r ) { item_->setGeometry( r ); }
int tqalignment() const { return item_->tqalignment(); }
TQLayoutItem *item() { return item_; }
TQLayoutItem *takeItem() { TQLayoutItem *i = item_; item_ = 0; return i; }
int hStretch() { return item_->widget() ?
TQT_TQSIZEPOLICY_OBJECT(item_->widget()->sizePolicy()).horStretch() : 0; }
int vStretch() { return item_->widget() ?
TQT_TQSIZEPOLICY_OBJECT(item_->widget()->sizePolicy()).verStretch() : 0; }
private:
friend class TQGridLayoutData;
friend class TQGridLayoutDataIterator;
TQLayoutItem *item_;
int row, col;
};
class TQGridMultiBox
{
public:
TQGridMultiBox( TQGridBox *box, int toRow, int toCol )
: box_( box ), torow( toRow ), tocol( toCol ) { }
~TQGridMultiBox() { delete box_; }
TQGridBox *box() { return box_; }
TQLayoutItem *takeItem() { return box_->takeItem(); }
private:
friend class TQGridLayoutData;
friend class TQGridLayoutDataIterator;
TQGridBox *box_;
int torow, tocol;
};
class TQGridLayoutData
{
public:
TQGridLayoutData();
TQGridLayoutData( int nRows, int nCols );
~TQGridLayoutData();
void add( TQGridBox*, int row, int col );
void add( TQGridBox*, int row1, int row2, int col1, int col2 );
QSize sizeHint( int ) const;
QSize tqminimumSize( int ) const;
QSize tqmaximumSize( int ) const;
TQ_SPExpandData expanding( int spacing );
void distribute( TQRect, int );
inline int numRows() const { return rr; }
inline int numCols() const { return cc; }
inline void expand( int rows, int cols )
{ setSize( TQMAX(rows, rr), TQMAX(cols, cc) ); }
inline void setRowStretch( int r, int s )
{ expand( r + 1, 0 ); rStretch[r] = s; setDirty(); }
inline void setColStretch( int c, int s )
{ expand( 0, c + 1 ); cStretch[c] = s; setDirty(); }
inline int rowStretch( int r ) const { return rStretch[r]; }
inline int colStretch( int c ) const { return cStretch[c]; }
inline void setRowSpacing( int r, int s )
{ expand( r + 1, 0 ); rSpacing[r] = s; setDirty(); }
inline void setColSpacing( int c, int s )
{ expand( 0, c + 1 ); cSpacing[c] = s; setDirty(); }
inline int rowSpacing( int r ) const { return rSpacing[r]; }
inline int colSpacing( int c ) const { return cSpacing[c]; }
inline void setReversed( bool r, bool c ) { hReversed = c; vReversed = r; }
inline bool horReversed() const { return hReversed; }
inline bool verReversed() const { return vReversed; }
inline void setDirty() { needRecalc = TRUE; hfw_width = -1; }
inline bool isDirty() const { return needRecalc; }
bool hasHeightForWidth( int space );
int heightForWidth( int, int, int );
int minimumHeightForWidth( int, int, int );
bool tqfindWidget( TQWidget* w, int *row, int *col );
inline void getNextPos( int &row, int &col ) { row = nextR; col = nextC; }
inline uint count() const
{ return things.count() + ( multi ? multi->count() : 0 ); }
TQRect cellGeometry( int row, int col ) const;
private:
void setNextPosAfter( int r, int c );
void recalcHFW( int w, int s );
void addHfwData ( TQGridBox *box, int width );
void init();
TQSize tqfindSize( TQCOORD TQLayoutStruct::*, int ) const;
void addData( TQGridBox *b, bool r = TRUE, bool c = TRUE );
void setSize( int rows, int cols );
void setupLayoutData( int space );
void setupHfwLayoutData( int space );
int rr;
int cc;
TQMemArray<TQLayoutStruct> rowData;
TQMemArray<TQLayoutStruct> colData;
TQMemArray<TQLayoutStruct> *hfwData;
TQMemArray<int> rStretch;
TQMemArray<int> cStretch;
TQMemArray<int> rSpacing;
TQMemArray<int> cSpacing;
TQPtrList<TQGridBox> things;
TQPtrList<TQGridMultiBox> *multi;
int hfw_width;
int hfw_height;
int hfw_minheight;
int nextR;
int nextC;
uint hReversed : 1;
uint vReversed : 1;
uint needRecalc : 1;
uint has_hfw : 1;
uint addVertical : 1;
friend class TQGridLayoutDataIterator;
};
TQGridLayoutData::TQGridLayoutData()
{
init();
}
TQGridLayoutData::TQGridLayoutData( int nRows, int nCols )
: rowData( 0 ), colData( 0 )
{
init();
if ( nRows < 0 ) {
nRows = 1;
addVertical = FALSE;
}
if ( nCols < 0 ) {
nCols = 1;
addVertical = TRUE;
}
setSize( nRows, nCols );
}
TQGridLayoutData::~TQGridLayoutData()
{
// must be cleared while the data is still in a stable state
things.clear();
delete multi;
delete hfwData;
}
void TQGridLayoutData::init()
{
addVertical = FALSE;
setDirty();
multi = 0;
rr = cc = 0;
nextR = nextC = 0;
hfwData = 0;
things.setAutoDelete( TRUE );
hReversed = FALSE;
vReversed = FALSE;
}
bool TQGridLayoutData::hasHeightForWidth( int spacing )
{
setupLayoutData( spacing );
return has_hfw;
}
/*
Assumes that setupLayoutData() has been called, and that
qGeomCalc() has filled in colData with appropriate values.
*/
void TQGridLayoutData::recalcHFW( int w, int spacing )
{
/*
Go through all tqchildren, using colData and heightForWidth()
and put the results in hfw_rowData.
*/
if ( !hfwData )
hfwData = new TQMemArray<TQLayoutStruct>( rr );
setupHfwLayoutData( spacing );
TQMemArray<TQLayoutStruct> &rData = *hfwData;
int h = 0;
int mh = 0;
int n = 0;
for ( int r = 0; r < rr; r++ ) {
h += rData[r].sizeHint;
mh += rData[r].tqminimumSize;
if ( !rData[r].empty )
n++;
}
if ( n ) {
h += ( n - 1 ) * spacing;
mh += ( n - 1 ) * spacing;
}
hfw_width = w;
hfw_height = TQMIN( TQLAYOUTSIZE_MAX, h );
hfw_minheight = TQMIN( TQLAYOUTSIZE_MAX, mh );
}
int TQGridLayoutData::heightForWidth( int w, int margin, int spacing )
{
setupLayoutData( spacing );
if ( !has_hfw )
return -1;
if ( w + 2*margin != hfw_width ) {
qGeomCalc( colData, 0, cc, 0, w+2*margin, spacing );
recalcHFW( w+2*margin, spacing );
}
return hfw_height + 2*margin;
}
int TQGridLayoutData::minimumHeightForWidth( int w, int margin, int spacing )
{
(void) heightForWidth( w, margin, spacing );
return has_hfw ? (hfw_minheight + 2*margin) : -1;
}
bool TQGridLayoutData::tqfindWidget( TQWidget* w, int *row, int *col )
{
TQPtrListIterator<TQGridBox> it( things );
TQGridBox * box;
while ( (box = it.current()) != 0 ) {
++it;
if ( box->item()->widget() == w ) {
if ( row )
*row = box->row;
if ( col )
*col = box->col;
return TRUE;
}
}
if ( multi ) {
TQPtrListIterator<TQGridMultiBox> it( *multi );
TQGridMultiBox * mbox;
while ( (mbox = it.current()) != 0 ) {
++it;
box = mbox->box();
if ( box->item()->widget() == w ) {
if ( row )
*row = box->row;
if ( col )
*col = box->col;
return TRUE;
}
}
}
return FALSE;
}
TQSize TQGridLayoutData::tqfindSize( TQCOORD TQLayoutStruct::*size, int spacer ) const
{
TQGridLayoutData *that = (TQGridLayoutData *)this;
that->setupLayoutData( spacer );
int w = 0;
int h = 0;
int n = 0;
for ( int r = 0; r < rr; r++ ) {
h = h + rowData[r].*size;
if ( !rowData[r].empty )
n++;
}
if ( n )
h += ( n - 1 ) * spacer;
n = 0;
for ( int c = 0; c < cc; c++ ) {
w = w + colData[c].*size;
if ( !colData[c].empty )
n++;
}
if ( n )
w += ( n - 1 ) * spacer;
w = TQMIN( TQLAYOUTSIZE_MAX, w );
h = TQMIN( TQLAYOUTSIZE_MAX, h );
return TQSize( w, h );
}
TQ_SPExpandData TQGridLayoutData::expanding( int spacing )
{
setupLayoutData( spacing );
int ret = 0;
for ( int r = 0; r < rr; r++ ) {
if ( rowData[r].expansive ) {
ret |= (int) TQSizePolicy::Vertically;
break;
}
}
for ( int c = 0; c < cc; c++ ) {
if ( colData[c].expansive ) {
ret |= (int) TQSizePolicy::Horizontally;
break;
}
}
return (TQ_SPExpandData) ret;
}
QSize TQGridLayoutData::sizeHint( int spacer ) const
{
return tqfindSize( &TQLayoutStruct::sizeHint, spacer );
}
QSize TQGridLayoutData::tqmaximumSize( int spacer ) const
{
return tqfindSize( &TQLayoutStruct::tqmaximumSize, spacer );
}
QSize TQGridLayoutData::tqminimumSize( int spacer ) const
{
return tqfindSize( &TQLayoutStruct::tqminimumSize, spacer );
}
void TQGridLayoutData::setSize( int r, int c )
{
if ( (int)rowData.size() < r ) {
int newR = TQMAX( r, rr * 2 );
rowData.resize( newR );
rStretch.resize( newR );
rSpacing.resize( newR );
for ( int i = rr; i < newR; i++ ) {
rowData[i].init();
rStretch[i] = 0;
rSpacing[i] = 0;
}
}
if ( (int)colData.size() < c ) {
int newC = TQMAX( c, cc * 2 );
colData.resize( newC );
cStretch.resize( newC );
cSpacing.resize( newC );
for ( int i = cc; i < newC; i++ ) {
colData[i].init();
cStretch[i] = 0;
cSpacing[i] = 0;
}
}
if ( hfwData && (int)hfwData->size() < r ) {
delete hfwData;
hfwData = 0;
hfw_width = -1;
}
rr = r;
cc = c;
}
void TQGridLayoutData::setNextPosAfter( int row, int col )
{
if ( addVertical ) {
if ( col > nextC || (col == nextC && row >= nextR) ) {
nextR = row + 1;
nextC = col;
if ( nextR >= rr ) {
nextR = 0;
nextC++;
}
}
} else {
if ( row > nextR || (row == nextR && col >= nextC) ) {
nextR = row;
nextC = col + 1;
if ( nextC >= cc ) {
nextC = 0;
nextR++;
}
}
}
}
void TQGridLayoutData::add( TQGridBox *box, int row, int col )
{
expand( row+1, col+1 );
box->row = row;
box->col = col;
things.append( box );
setDirty();
setNextPosAfter( row, col );
}
void TQGridLayoutData::add( TQGridBox *box, int row1, int row2, int col1,
int col2 )
{
#ifdef TQT_CHECK_RANGE
if ( row2 >= 0 && row2 < row1 )
qWarning( "TQGridLayout: Multi-cell fromRow greater than toRow" );
if ( col2 >= 0 && col2 < col1 )
qWarning( "TQGridLayout: Multi-cell fromCol greater than toCol" );
#endif
if ( row1 == row2 && col1 == col2 ) {
add( box, row1, col1 );
return;
}
expand( row2+1, col2+1 );
box->row = row1;
box->col = col1;
TQGridMultiBox *mbox = new TQGridMultiBox( box, row2, col2 );
if ( !multi ) {
multi = new TQPtrList<TQGridMultiBox>;
multi->setAutoDelete( TRUE );
}
multi->append( mbox );
setDirty();
if ( col2 < 0 )
col2 = cc - 1;
setNextPosAfter( row2, col2 );
}
void TQGridLayoutData::addData( TQGridBox *box, bool r, bool c )
{
TQSize hint = box->sizeHint();
TQSize minS = box->tqminimumSize();
TQSize maxS = box->tqmaximumSize();
if ( c ) {
if ( !cStretch[box->col] )
colData[box->col].stretch = TQMAX( colData[box->col].stretch,
box->hStretch() );
colData[box->col].sizeHint = TQMAX( hint.width(),
colData[box->col].sizeHint );
colData[box->col].tqminimumSize = TQMAX( minS.width(),
colData[box->col].tqminimumSize );
qMaxExpCalc( colData[box->col].tqmaximumSize, colData[box->col].expansive,
maxS.width(),
box->expandingDirections() & TQSizePolicy::Horizontally );
}
if ( r ) {
if ( !rStretch[box->row] )
rowData[box->row].stretch = TQMAX( rowData[box->row].stretch,
box->vStretch() );
rowData[box->row].sizeHint = TQMAX( hint.height(),
rowData[box->row].sizeHint );
rowData[box->row].tqminimumSize = TQMAX( minS.height(),
rowData[box->row].tqminimumSize );
qMaxExpCalc( rowData[box->row].tqmaximumSize, rowData[box->row].expansive,
maxS.height(),
box->expandingDirections() & TQSizePolicy::Vertically );
}
if ( box->isEmpty() ) {
if ( box->item()->widget() != 0 ) {
/*
Hidden widgets should behave exactly the same as if
there were no widgets at all in the cell. We could have
TQWidgetItem::tqmaximumSize() to return
TQSize(TQLAYOUTSIZE_MAX, TQLAYOUTSIZE_MAX). However, that
value is not suitable for TQBoxLayouts. So let's fix it
here.
*/
if ( c )
colData[box->col].tqmaximumSize = TQLAYOUTSIZE_MAX;
if ( r )
rowData[box->row].tqmaximumSize = TQLAYOUTSIZE_MAX;
}
} else {
// Empty boxes (i.e. spacers) do not get borders. This is
// hacky, but compatible.
if ( c )
colData[box->col].empty = FALSE;
if ( r )
rowData[box->row].empty = FALSE;
}
}
static void distributeMultiBox( TQMemArray<TQLayoutStruct> &chain, int spacing,
int start, int end,
int minSize, int sizeHint,
TQMemArray<int> &stretchArray, int stretch )
{
int i;
int w = 0;
int wh = 0;
int max = 0;
for ( i = start; i <= end; i++ ) {
w += chain[i].tqminimumSize;
wh += chain[i].sizeHint;
max += chain[i].tqmaximumSize;
chain[i].empty = FALSE;
if ( stretchArray[i] == 0 )
chain[i].stretch = TQMAX(chain[i].stretch,stretch);
}
w += spacing * ( end - start );
wh += spacing * ( end - start );
max += spacing * ( end - start );
if ( max < minSize ) { // implies w < minSize
/*
We must increase the maximum size of at least one of the
items. qGeomCalc() will put the extra space in between the
items. We must recover that extra space and put it
somewhere. It does not really matter where, since the user
can always specify stretch factors and avoid this code.
*/
qGeomCalc( chain, start, end - start + 1, 0, minSize, spacing );
int pos = 0;
for ( i = start; i <= end; i++ ) {
int nextPos = ( i == end ) ? minSize - 1 : chain[i + 1].pos;
int realSize = nextPos - pos;
if ( i != end )
realSize -= spacing;
if ( chain[i].tqminimumSize < realSize )
chain[i].tqminimumSize = realSize;
if ( chain[i].tqmaximumSize < chain[i].tqminimumSize )
chain[i].tqmaximumSize = chain[i].tqminimumSize;
pos = nextPos;
}
} else if ( w < minSize ) {
qGeomCalc( chain, start, end - start + 1, 0, minSize, spacing );
for ( i = start; i <= end; i++ ) {
if ( chain[i].tqminimumSize < chain[i].size )
chain[i].tqminimumSize = chain[i].size;
}
}
if ( wh < sizeHint ) {
qGeomCalc( chain, start, end - start + 1, 0, sizeHint, spacing );
for ( i = start; i <= end; i++ ) {
if ( chain[i].sizeHint < chain[i].size )
chain[i].sizeHint = chain[i].size;
}
}
}
//#define TQT_LAYOUT_DISABLE_CACHING
void TQGridLayoutData::setupLayoutData( int spacing )
{
#ifndef TQT_LAYOUT_DISABLE_CACHING
if ( !needRecalc )
return;
#endif
has_hfw = FALSE;
int i;
for ( i = 0; i < rr; i++ )
rowData[i].init( rStretch[i], rSpacing[i] );
for ( i = 0; i < cc; i++ )
colData[i].init( cStretch[i], cSpacing[i] );
TQPtrListIterator<TQGridBox> it( things );
TQGridBox * box;
while ( (box = it.current()) != 0 ) {
++it;
addData( box );
has_hfw = has_hfw || box->item()->hasHeightForWidth();
}
if ( multi ) {
TQPtrListIterator<TQGridMultiBox> it( *multi );
TQGridMultiBox * mbox;
while ( (mbox = it.current()) != 0 ) {
++it;
TQGridBox *box = mbox->box();
int r1 = box->row;
int c1 = box->col;
int r2 = mbox->torow;
int c2 = mbox->tocol;
if ( r2 < 0 )
r2 = rr - 1;
if ( c2 < 0 )
c2 = cc - 1;
TQSize hint = box->sizeHint();
TQSize min = box->tqminimumSize();
if ( box->hasHeightForWidth() )
has_hfw = TRUE;
if ( r1 == r2 ) {
addData( box, TRUE, FALSE );
} else {
distributeMultiBox( rowData, spacing, r1, r2,
min.height(), hint.height(),
rStretch, box->vStretch() );
}
if ( c1 == c2 ) {
addData( box, FALSE, TRUE );
} else {
distributeMultiBox( colData, spacing, c1, c2,
min.width(), hint.width(),
cStretch, box->hStretch() );
}
}
}
for ( i = 0; i < rr; i++ )
rowData[i].expansive = rowData[i].expansive || rowData[i].stretch > 0;
for ( i = 0; i < cc; i++ )
colData[i].expansive = colData[i].expansive || colData[i].stretch > 0;
needRecalc = FALSE;
}
void TQGridLayoutData::addHfwData( TQGridBox *box, int width )
{
TQMemArray<TQLayoutStruct> &rData = *hfwData;
if ( box->hasHeightForWidth() ) {
int hint = box->heightForWidth( width );
rData[box->row].sizeHint = TQMAX( hint, rData[box->row].sizeHint );
rData[box->row].tqminimumSize = TQMAX( hint, rData[box->row].tqminimumSize );
} else {
TQSize hint = box->sizeHint();
TQSize minS = box->tqminimumSize();
rData[box->row].sizeHint = TQMAX( hint.height(),
rData[box->row].sizeHint );
rData[box->row].tqminimumSize = TQMAX( minS.height(),
rData[box->row].tqminimumSize );
}
}
/*
Similar to setupLayoutData(), but uses heightForWidth(colData)
instead of sizeHint(). Assumes that setupLayoutData() and
qGeomCalc(colData) has been called.
*/
void TQGridLayoutData::setupHfwLayoutData( int spacing )
{
TQMemArray<TQLayoutStruct> &rData = *hfwData;
int i;
for ( i = 0; i < rr; i++ ) {
rData[i] = rowData[i];
rData[i].tqminimumSize = rData[i].sizeHint = 0;
}
TQPtrListIterator<TQGridBox> it( things );
TQGridBox * box;
while ( (box=it.current()) != 0 ) {
++it;
addHfwData( box, colData[box->col].size );
}
if ( multi ) {
TQPtrListIterator<TQGridMultiBox> it( *multi );
TQGridMultiBox * mbox;
while ( (mbox=it.current()) != 0 ) {
++it;
TQGridBox *box = mbox->box();
int r1 = box->row;
int c1 = box->col;
int r2 = mbox->torow;
int c2 = mbox->tocol;
if ( r2 < 0 )
r2 = rr-1;
if ( c2 < 0 )
c2 = cc-1;
int w = colData[c2].pos + colData[c2].size - colData[c1].pos;
if ( r1 == r2 ) {
addHfwData( box, w );
} else {
TQSize hint = box->sizeHint();
TQSize min = box->tqminimumSize();
if ( box->hasHeightForWidth() ) {
int hfwh = box->heightForWidth( w );
if ( hfwh > hint.height() )
hint.setHeight( hfwh );
if ( hfwh > min.height() )
min.setHeight( hfwh );
}
distributeMultiBox( rData, spacing, r1, r2,
min.height(), hint.height(),
rStretch, box->vStretch() );
}
}
}
for ( i = 0; i < rr; i++ )
rData[i].expansive = rData[i].expansive || rData[i].stretch > 0;
}
void TQGridLayoutData::distribute( TQRect r, int spacing )
{
bool visualHReversed = hReversed;
if ( TQApplication::reverseLayout() )
visualHReversed = !visualHReversed;
setupLayoutData( spacing );
qGeomCalc( colData, 0, cc, r.x(), r.width(), spacing );
TQMemArray<TQLayoutStruct> *rDataPtr;
if ( has_hfw ) {
recalcHFW( r.width(), spacing );
qGeomCalc( *hfwData, 0, rr, r.y(), r.height(), spacing );
rDataPtr = hfwData;
} else {
qGeomCalc( rowData, 0, rr, r.y(), r.height(), spacing );
rDataPtr = &rowData;
}
TQMemArray<TQLayoutStruct> &rData = *rDataPtr;
TQPtrListIterator<TQGridBox> it( things );
TQGridBox * box;
while ( (box=it.current()) != 0 ) {
++it;
int x = colData[box->col].pos;
int y = rData[box->row].pos;
int w = colData[box->col].size;
int h = rData[box->row].size;
if ( visualHReversed )
x = r.left() + r.right() - x - w + 1;
if ( vReversed )
y = r.top() + r.bottom() - y - h + 1;
box->setGeometry( TQRect( x, y, w, h ) );
}
if ( multi ) {
TQPtrListIterator<TQGridMultiBox> it( *multi );
TQGridMultiBox * mbox;
while ( (mbox=it.current()) != 0 ) {
++it;
TQGridBox *box = mbox->box();
int r2 = mbox->torow;
int c2 = mbox->tocol;
if ( r2 < 0 )
r2 = rr-1;
if ( c2 < 0 )
c2 = cc-1;
int x = colData[box->col].pos;
int y = rData[box->row].pos;
int x2p = colData[c2].pos + colData[c2].size; // x2+1
int y2p = rData[r2].pos + rData[r2].size; // y2+1
int w = x2p - x;
int h = y2p - y;
// this code is copied from above:
if ( visualHReversed )
x = r.left() + r.right() - x - w + 1;
if ( vReversed )
y = r.top() + r.bottom() - y - h + 1;
box->setGeometry( TQRect( x, y, w, h ) );
}
}
}
TQRect TQGridLayoutData::cellGeometry( int row, int col ) const
{
if ( row < 0 || row >= rr || col < 0 || col >= cc )
return TQRect();
const TQMemArray<TQLayoutStruct> *rDataPtr;
if ( has_hfw )
rDataPtr = hfwData;
else
rDataPtr = &rowData;
return TQRect( colData[col].pos, (*rDataPtr)[row].pos,
colData[col].size, (*rDataPtr)[row].size );
}
class TQGridLayoutDataIterator : public TQGLayoutIterator
{
public:
TQGridLayoutDataIterator( TQGridLayoutData *d );
uint count() const { return data->count(); }
TQLayoutItem *current() {
if ( multi ) {
if ( !data->multi || idx >= (int)data->multi->count() )
return 0;
return data->multi->at( idx )->box()->item();
} else {
if ( idx >= (int)data->things.count() )
return 0;
return data->things.at( idx )->item();
}
}
void toFirst() {
multi = data->things.isEmpty();
idx = 0;
}
TQLayoutItem *next() {
idx++;
if ( !multi && idx >= (int)data->things.count() ) {
multi = TRUE;
idx = 0;
}
return current();
}
TQLayoutItem *takeCurrent() {
TQLayoutItem *item = 0;
if ( multi ) {
if ( !data->multi || idx >= (int)data->multi->count() )
return 0;
TQGridMultiBox *b = data->multi->take( idx );
item = b->takeItem();
delete b;
} else {
if ( idx >= (int)data->things.count() )
return 0;
TQGridBox *b = data->things.take( idx );
item = b->takeItem();
delete b;
}
return item;
}
private:
TQGridLayoutData *data;
bool multi;
int idx;
};
inline TQGridLayoutDataIterator::TQGridLayoutDataIterator( TQGridLayoutData *d )
: data( d )
{
toFirst();
}
/*!
\class TQGridLayout
\brief The TQGridLayout class lays out widgets in a grid.
\ingroup geomanagement
\ingroup appearance
\mainclass
TQGridLayout takes the space made available to it (by its tqparent
tqlayout or by the mainWidget()), divides it up into rows and
columns, and puts each widget it manages into the correct cell.
Columns and rows behave identically; we will discuss columns, but
there are equivalent functions for rows.
Each column has a minimum width and a stretch factor. The minimum
width is the greatest of that set using addColSpacing() and the
minimum width of each widget in that column. The stretch factor is
set using setColStretch() and determines how much of the available
space the column will get over and above its necessary minimum.
Normally, each managed widget or tqlayout is put into a cell of its
own using addWidget(), addLayout() or by the \link
TQLayout::setAutoAdd() auto-add facility\endlink. It is also
possible for a widget to occupy multiple cells using
addMultiCellWidget(). If you do this, TQGridLayout will guess how
to distribute the size over the columns/rows (based on the stretch
factors).
To remove a widget from a tqlayout, call remove(). Calling
TQWidget::hide() on a widget also effectively removes the widget
from the tqlayout until TQWidget::show() is called.
This illustration shows a fragment of a dialog with a five-column,
three-row grid (the grid is shown overlaid in magenta):
\img gridtqlayout.png
Columns 0, 2 and 4 in this dialog fragment are made up of a
TQLabel, a TQLineEdit, and a TQListBox. Columns 1 and 3 are
placeholders made with addColSpacing(). Row 0 consists of three
TQLabel objects, row 1 of three TQLineEdit objects and row 2 of
three TQListBox objects. We used placeholder columns (1 and 3) to
get the right amount of space between the columns.
Note that the columns and rows are not equally wide or tall. If
you want two columns to have the same width, you must set their
minimum widths and stretch factors to be the same yourself. You do
this using addColSpacing() and setColStretch().
If the TQGridLayout is not the top-level tqlayout (i.e. does not
manage all of the widget's area and tqchildren), you must add it to
its tqparent tqlayout when you create it, but before you do anything
with it. The normal way to add a tqlayout is by calling
parentLayout-\>addLayout().
Once you have added your tqlayout you can start putting widgets and
other layouts into the cells of your grid tqlayout using
addWidget(), addLayout() and addMultiCellWidget().
TQGridLayout also includes two margin widths: the border and the
spacing. The border is the width of the reserved space along each
of the TQGridLayout's four sides. The spacing is the width of the
automatically allocated spacing between neighboring boxes.
Both the border and the spacing are parameters of the constructor
and default to 0.
\sa TQGrid, \link tqlayout.html Layout Overview \endlink
*/
/*
Returns TRUE if the widget \a w can be added to the tqlayout \a l;
otherwise returns FALSE.
*/
static bool checkWidget( TQLayout *l, TQWidget *w )
{
if ( !w ) {
#if defined(TQT_CHECK_STATE)
qWarning( "TQLayout: Cannot add null widget to %s/%s", l->className(),
l->name() );
#endif
return FALSE;
}
if ( w->parentWidget() != l->mainWidget() && l->mainWidget() ) {
#if defined(TQT_CHECK_STATE)
if ( w->parentWidget() )
qWarning( "TQLayout: Adding %s/%s (child of %s/%s) to tqlayout for "
"%s/%s", w->className(), w->name(),
w->parentWidget()->className(), w->parentWidget()->name(),
l->mainWidget()->className(), l->mainWidget()->name() );
else
qWarning( "TQLayout: Adding %s/%s (top-level widget) to tqlayout for"
" %s/%s", w->className(), w->name(),
l->mainWidget()->className(), l->mainWidget()->name() );
#endif
return FALSE;
}
return TRUE;
}
// #ifdef USE_QT4
//
// #else // USE_QT4
/*!
\enum TQGridLayout::Corner
This enum identifies which corner is the origin (0, 0) of the
tqlayout.
\value TopLeft the top-left corner
\value TopRight the top-right corner
\value BottomLeft the bottom-left corner
\value BottomRight the bottom-right corner
*/
/*!
Constructs a new TQGridLayout with \a nRows rows, \a nCols columns
and tqparent widget, \a tqparent. \a tqparent may not be 0. The grid
tqlayout is called \a name.
\a margin is the number of pixels between the edge of the widget
and its managed tqchildren. \a space is the default number of pixels
between cells. If \a space is -1, the value of \a margin is used.
*/
TQGridLayout::TQGridLayout( TQWidget *tqparent, int nRows, int nCols, int margin,
int space, const char *name )
: TQLayout( tqparent, margin, space, name )
{
init( nRows, nCols );
}
/*!
Constructs a new grid that is placed inside \a parentLayout with
\a nRows rows and \a nCols columns. If \a spacing is -1, this
TQGridLayout inherits its tqparent's spacing(); otherwise \a spacing
is used. The grid tqlayout is called \a name.
This grid is placed according to \a parentLayout's default
placement rules.
*/
TQGridLayout::TQGridLayout( TQLayout *parentLayout, int nRows, int nCols,
int spacing, const char *name )
: TQLayout( parentLayout, spacing, name )
{
init( nRows, nCols );
}
/*!
Constructs a new grid with \a nRows rows and \a nCols columns. If
\a spacing is -1, this TQGridLayout inherits its tqparent's
spacing(); otherwise \a spacing is used. The grid tqlayout is called
\a name.
You must insert this grid into another tqlayout. You can insert
widgets and layouts into this tqlayout at any time, but laying out
will not be performed before this is inserted into another tqlayout.
*/
TQGridLayout::TQGridLayout( int nRows, int nCols,
int spacing, const char *name )
: TQLayout( spacing, name )
{
init( nRows, nCols );
}
/*!
Destroys the grid tqlayout. Geometry management is terminated if
this is a top-level grid.
The tqlayout's widgets aren't destroyed.
*/
TQGridLayout::~TQGridLayout()
{
delete data;
}
/*!
Returns the number of rows in this grid.
*/
int TQGridLayout::numRows() const
{
return data->numRows();
}
/*!
Returns the number of columns in this grid.
*/
int TQGridLayout::numCols() const
{
return data->numCols();
}
/*!
Returns the preferred size of this grid.
*/
TQSize TQGridLayout::sizeHint() const
{
return data->sizeHint( spacing() ) + TQSize( 2 * margin(), 2 * margin() );
}
/*!
Returns the minimum size needed by this grid.
*/
TQSize TQGridLayout::tqminimumSize() const
{
return data->tqminimumSize( spacing() ) + TQSize( 2 * margin(), 2 * margin() );
}
/*!
Returns the maximum size needed by this grid.
*/
TQSize TQGridLayout::tqmaximumSize() const
{
TQSize s = data->tqmaximumSize( spacing() ) +
TQSize( 2 * margin(), 2 * margin() );
s = s.boundedTo( TQSize(TQLAYOUTSIZE_MAX, TQLAYOUTSIZE_MAX) );
if ( tqalignment() & TQt::AlignHorizontal_Mask )
s.setWidth( TQLAYOUTSIZE_MAX );
if ( tqalignment() & TQt::AlignVertical_Mask )
s.setHeight( TQLAYOUTSIZE_MAX );
return s;
}
/*!
Returns TRUE if this tqlayout's preferred height depends on its
width; otherwise returns FALSE.
*/
bool TQGridLayout::hasHeightForWidth() const
{
return ((TQGridLayout*)this)->data->hasHeightForWidth( spacing() );
}
/*!
Returns the tqlayout's preferred height when it is \a w pixels wide.
*/
int TQGridLayout::heightForWidth( int w ) const
{
TQGridLayout *that = (TQGridLayout*)this;
return that->data->heightForWidth( w, margin(), spacing() );
}
/*! \internal */
int TQGridLayout::minimumHeightForWidth( int w ) const
{
TQGridLayout *that = (TQGridLayout*)this;
return that->data->minimumHeightForWidth( w, margin(), spacing() );
}
/*!
Searches for widget \a w in this tqlayout (not including child
layouts). If \a w is found, it sets \c \a row and \c \a col to
the row and column and returns TRUE; otherwise returns FALSE.
Note: if a widget spans multiple rows/columns, the top-left cell
is returned.
*/
bool TQGridLayout::tqfindWidget( TQWidget* w, int *row, int *col )
{
return data->tqfindWidget( w, row, col );
}
/*!
Resizes managed widgets within the rectangle \a r.
*/
void TQGridLayout::setGeometry( const TQRect &r )
{
if ( data->isDirty() || r != tqgeometry() ) {
TQLayout::setGeometry( r );
TQRect cr = tqalignment() ? alignmentRect( r ) : r;
TQRect s( cr.x() + margin(), cr.y() + margin(),
cr.width() - 2 * margin(), cr.height() - 2 * margin() );
data->distribute( s, spacing() );
}
}
/*!
Returns the tqgeometry of the cell with row \a row and column \a col
in the grid. Returns an invalid rectangle if \a row or \a col is
outside the grid.
\warning in the current version of TQt this function does not
return valid results until setGeometry() has been called, i.e.
after the mainWidget() is visible.
*/
TQRect TQGridLayout::cellGeometry( int row, int col ) const
{
return data->cellGeometry( row, col );
}
/*!
Expands this grid so that it will have \a nRows rows and \a nCols
columns. Will not shrink the grid. You should not need to call
this function because TQGridLayout expands automatically as new
items are inserted.
*/
void TQGridLayout::expand( int nRows, int nCols )
{
data->expand( nRows, nCols );
}
/*!
Sets up the grid.
*/
void TQGridLayout::init( int nRows, int nCols )
{
setSupportsMargin( TRUE );
data = new TQGridLayoutData( nRows, nCols );
}
/*!
\overload
Adds \a item to the next free position of this tqlayout.
*/
void TQGridLayout::addItem( QLayoutItem *item )
{
int r, c;
data->getNextPos( r, c );
add( TQT_TQLAYOUTITEM(item), r, c );
}
/*!
Adds \a item at position \a row, \a col. The tqlayout takes
ownership of the \a item.
*/
void TQGridLayout::addItem( QLayoutItem *item, int row, int col )
{
add( TQT_TQLAYOUTITEM(item), row, col );
}
/*!
Adds \a item at position \a row, \a col. The tqlayout takes
ownership of the \a item.
*/
void TQGridLayout::add( TQLayoutItem *item, int row, int col )
{
TQGridBox *box = new TQGridBox( item );
data->add( box, row, col );
}
/*!
Adds the \a item to the cell grid, spanning multiple rows/columns.
The cell will span from \a fromRow, \a fromCol to \a toRow, \a
toCol. Alignment is specified by \a tqalignment, which is a bitwise
OR of \l TQt::AlignmentFlags values. The default tqalignment is 0,
which means that the widget fills the entire cell.
*/
void TQGridLayout::addMultiCell( QLayoutItem *item, int fromRow, int toRow,
int fromCol, int toCol, int tqalignment )
{
TQGridBox *b = new TQGridBox( TQT_TQLAYOUTITEM(item) );
b->tqsetAlignment( tqalignment );
data->add( b, fromRow, toRow, fromCol, toCol );
}
/*!
Adds the widget \a w to the cell grid at \a row, \a col. The
top-left position is (0, 0) by default.
Alignment is specified by \a tqalignment, which is a bitwise OR of
\l TQt::AlignmentFlags values. The default tqalignment is 0, which
means that the widget fills the entire cell.
\list
\i You should not call this if you have enabled the
\link TQLayout::setAutoAdd() auto-add facility of the tqlayout\endlink.
\i From TQt 3.0, the \a tqalignment parameter is interpreted more
aggressively than in previous versions of TQt. A non-default
tqalignment now indicates that the widget should not grow to fill
the available space, but should be sized according to sizeHint().
\endlist
\sa addMultiCellWidget()
*/
void TQGridLayout::addWidget( TQWidget *w, int row, int col, int tqalignment )
{
if ( !checkWidget( this, w ) )
return;
if ( row < 0 || col < 0 ) {
#if defined(TQT_CHECK_STATE)
qWarning( "TQGridLayout: Cannot add %s/%s to %s/%s at row %d col %d",
w->className(), w->name(), className(), name(), row, col );
#endif
return;
}
TQWidgetItem *b = new TQWidgetItem( w );
b->tqsetAlignment( tqalignment );
add( b, row, col );
}
/*!
Adds the widget \a w to the cell grid, spanning multiple
rows/columns. The cell will span from \a fromRow, \a fromCol to \a
toRow, \a toCol.
Alignment is specified by \a tqalignment, which is a bitwise OR of
\l TQt::AlignmentFlags values. The default tqalignment is 0, which
means that the widget fills the entire cell.
A non-zero tqalignment indicates that the widget should not grow to
fill the available space but should be sized according to
sizeHint().
\sa addWidget()
*/
void TQGridLayout::addMultiCellWidget( TQWidget *w, int fromRow, int toRow,
int fromCol, int toCol, int tqalignment )
{
TQGridBox *b = new TQGridBox( w );
b->tqsetAlignment( tqalignment );
data->add( b, fromRow, toRow, fromCol, toCol );
}
/*!
Places the \a tqlayout at position (\a row, \a col) in the grid. The
top-left position is (0, 0).
\a tqlayout becomes a child of the grid tqlayout.
When a tqlayout is constructed with another tqlayout as its tqparent,
you don't need to call addLayout(); the child tqlayout is
automatically added to the tqparent tqlayout as it is constructed.
\sa addMultiCellLayout()
*/
void TQGridLayout::addLayout( TQLayout *tqlayout, int row, int col )
{
addChildLayout( tqlayout );
add( TQT_TQLAYOUTITEM(tqlayout), row, col );
}
/*!
Adds the tqlayout \a tqlayout to the cell grid, spanning multiple
rows/columns. The cell will span from \a fromRow, \a fromCol to \a
toRow, \a toCol.
Alignment is specified by \a tqalignment, which is a bitwise OR of
\l TQt::AlignmentFlags values. The default tqalignment is 0, which
means that the widget fills the entire cell.
A non-zero tqalignment indicates that the tqlayout should not grow to
fill the available space but should be sized according to
sizeHint().
\a tqlayout becomes a child of the grid tqlayout.
\sa addLayout()
*/
void TQGridLayout::addMultiCellLayout( TQLayout *tqlayout, int fromRow, int toRow,
int fromCol, int toCol, int tqalignment )
{
addChildLayout( tqlayout );
TQGridBox *b = new TQGridBox( TQT_TQLAYOUTITEM(tqlayout) );
b->tqsetAlignment( tqalignment );
data->add( b, fromRow, toRow, fromCol, toCol );
}
/*!
Sets the stretch factor of row \a row to \a stretch. The first row
is number 0.
The stretch factor is relative to the other rows in this grid.
Rows with a higher stretch factor take more of the available
space.
The default stretch factor is 0. If the stretch factor is 0 and no
other row in this table can grow at all, the row may still grow.
\sa rowStretch(), setRowSpacing(), setColStretch()
*/
void TQGridLayout::setRowStretch( int row, int stretch )
{
data->setRowStretch( row, stretch );
}
/*!
Returns the stretch factor for row \a row.
\sa setRowStretch()
*/
int TQGridLayout::rowStretch( int row ) const
{
return data->rowStretch( row );
}
/*!
Returns the stretch factor for column \a col.
\sa setColStretch()
*/
int TQGridLayout::colStretch( int col ) const
{
return data->colStretch( col );
}
/*!
Sets the stretch factor of column \a col to \a stretch. The first
column is number 0.
The stretch factor is relative to the other columns in this grid.
Columns with a higher stretch factor take more of the available
space.
The default stretch factor is 0. If the stretch factor is 0 and no
other column in this table can grow at all, the column may still
grow.
\sa colStretch(), addColSpacing(), setRowStretch()
*/
void TQGridLayout::setColStretch( int col, int stretch )
{
data->setColStretch( col, stretch );
}
#if TQT_VERSION >= 0x040000
#error "Make add{Row,Col}Spacing() inline TQT_NO_COMPAT functions defined in terms of set{Row,Col}Spacing()"
#endif
/*!
\obsolete
Sets the minimum height of row \a row to \a minsize pixels.
Use setRowSpacing() instead.
*/
void TQGridLayout::addRowSpacing( int row, int minsize )
{
TQLayoutItem *b = TQT_TQLAYOUTITEM(new TQSpacerItem( 0, minsize ));
add( b, row, 0 );
}
/*!
\obsolete
Sets the minimum width of column \a col to \a minsize pixels.
Use setColSpacing() instead.
*/
void TQGridLayout::addColSpacing( int col, int minsize )
{
TQLayoutItem *b = TQT_TQLAYOUTITEM(new TQSpacerItem( minsize, 0 ));
add( b, 0, col );
}
/*!
Sets the minimum height of row \a row to \a minSize pixels.
\sa rowSpacing(), setColSpacing()
*/
void TQGridLayout::setRowSpacing( int row, int minSize )
{
data->setRowSpacing( row, minSize );
}
/*!
Returns the row spacing for row \a row.
\sa setRowSpacing()
*/
int TQGridLayout::rowSpacing( int row ) const
{
return data->rowSpacing( row );
}
/*!
Sets the minimum width of column \a col to \a minSize pixels.
\sa colSpacing(), setRowSpacing()
*/
void TQGridLayout::setColSpacing( int col, int minSize )
{
data->setColSpacing( col, minSize );
}
/*!
Returns the column spacing for column \a col.
\sa setColSpacing()
*/
int TQGridLayout::colSpacing( int col ) const
{
return data->colSpacing( col );
}
/*!
Returns whether this tqlayout can make use of more space than
sizeHint(). A value of \c Vertical or \c Horizontal means that it wants
to grow in only one dimension, whereas \c BothDirections means that
it wants to grow in both dimensions.
*/
TQ_SPExpandData TQGridLayout::expandingDirections() const
{
return data->expanding( spacing() );
}
/*!
Sets the grid's origin corner, i.e. position (0, 0), to \a c.
*/
void TQGridLayout::setOrigin( Corner c )
{
data->setReversed( c == BottomLeft || c == BottomRight,
c == TopRight || c == BottomRight );
}
/*!
Returns the corner that's used for the grid's origin, i.e. for
position (0, 0).
*/
TQGridLayout::Corner TQGridLayout::origin() const
{
if ( data->horReversed() ) {
return data->verReversed() ? BottomRight : TopRight;
} else {
return data->verReversed() ? BottomLeft : TopLeft;
}
}
/*!
Resets cached information.
*/
void TQGridLayout::tqinvalidate()
{
TQLayout::tqinvalidate();
TQLayout::setGeometry( TQRect() ); // for binary compatibility (?)
data->setDirty();
}
/*! \reimp */
// TQLayoutIterator TQGridLayout::iterator()
// {
// return TQLayoutIterator( new TQGridLayoutDataIterator(data) );
// }
#ifdef USE_QT4
/*!
\reimp
*/
int TQGridLayout::count() const {
return data->count();
}
/*!
\reimp
*/
TQLayoutItem* TQGridLayout::itemAt(int index) const {
TQGridLayoutDataIterator tqgli = TQGridLayoutDataIterator(data);
for (int i=0; i<index; i++) { tqgli.next(); }
return index >= 0 && index < data->count() ? tqgli.current() : 0;
}
/*!
\reimp
*/
TQLayoutItem* TQGridLayout::takeAt(int index) {
if (index < 0 || index >= data->count())
return 0;
TQGridLayoutDataIterator tqgli = TQGridLayoutDataIterator(data);
for (int i=0; i<index; i++) { tqgli.next(); }
return tqgli.takeCurrent();
}
#endif // USE_QT4
// #endif // USE_QT4
struct TQBoxLayoutItem
{
TQBoxLayoutItem( TQLayoutItem *it, int stretch_ = 0 )
: item( it ), stretch( stretch_ ), magic( FALSE ) { }
~TQBoxLayoutItem() { delete item; }
int hfw( int w ) {
if ( item->hasHeightForWidth() ) {
return item->heightForWidth( w );
} else {
return item->sizeHint().height();
}
}
int mhfw( int w ) {
if ( item->hasHeightForWidth() ) {
return item->heightForWidth( w );
} else {
return item->minimumSize().height();
}
}
int hStretch() {
if ( stretch == 0 && item->widget() ) {
return TQT_TQSIZEPOLICY_OBJECT(item->widget()->sizePolicy()).horStretch();
} else {
return stretch;
}
}
int vStretch() {
if ( stretch == 0 && item->widget() ) {
return TQT_TQSIZEPOLICY_OBJECT(item->widget()->sizePolicy()).verStretch();
} else {
return stretch;
}
}
TQLayoutItem *item;
int stretch;
bool magic;
};
class TQBoxLayoutData
{
public:
TQBoxLayoutData() : geomArray( 0 ), hfwWidth( -1 ), dirty( TRUE )
{ list.setAutoDelete( TRUE ); }
~TQBoxLayoutData() { delete geomArray; }
void setDirty() {
delete geomArray;
geomArray = 0;
hfwWidth = -1;
hfwHeight = -1;
dirty = TRUE;
}
TQPtrList<TQBoxLayoutItem> list;
TQMemArray<TQLayoutStruct> *geomArray;
int hfwWidth;
int hfwHeight;
int hfwMinHeight;
TQSize sizeHint;
TQSize minSize;
TQSize maxSize;
TQ_SPExpandData expanding;
uint hasHfw : 1;
uint dirty : 1;
};
class TQBoxLayoutIterator : public TQGLayoutIterator
{
public:
TQBoxLayoutIterator( TQBoxLayoutData *d ) : data( d ), idx( 0 ) {}
TQLayoutItem *current() {
if ( idx >= int(data->list.count()) )
return 0;
return data->list.at(idx)->item;
}
TQLayoutItem *next() {
idx++;
return current();
}
TQLayoutItem *takeCurrent() {
TQLayoutItem *item = 0;
TQBoxLayoutItem *b = data->list.take( idx );
if ( b ) {
item = b->item;
b->item = 0;
delete b;
}
data->setDirty();
return item;
}
private:
TQBoxLayoutData *data;
int idx;
};
/*!
\class TQBoxLayout
\brief The TQBoxLayout class lines up child widgets horizontally or
vertically.
\ingroup geomanagement
\ingroup appearance
TQBoxLayout takes the space it gets (from its tqparent tqlayout or from
the mainWidget()), divides it up into a row of boxes, and makes
each managed widget fill one box.
\img qhbox-m.png Horizontal box with five child widgets
If the TQBoxLayout's orientation is \c Horizontal the boxes are
placed in a row, with suitable sizes. Each widget (or other box)
will get at least its minimum size and at most its maximum size.
Any excess space is shared according to the stretch factors (more
about that below).
\img qvbox-m.png Vertical box with five child widgets
If the TQBoxLayout's orientation is \c Vertical, the boxes are
placed in a column, again with suitable sizes.
The easiest way to create a TQBoxLayout is to use one of the
convenience classes, e.g. TQHBoxLayout (for \c Horizontal boxes) or
TQVBoxLayout (for \c Vertical boxes). You can also use the
TQBoxLayout constructor directly, specifying its direction as \c
LeftToRight, \c Down, \c RightToLeft or \c Up.
If the TQBoxLayout is not the top-level tqlayout (i.e. it is not
managing all of the widget's area and tqchildren), you must add it
to its tqparent tqlayout before you can do anything with it. The
normal way to add a tqlayout is by calling
parentLayout-\>addLayout().
Once you have done this, you can add boxes to the TQBoxLayout using
one of four functions:
\list
\i addWidget() to add a widget to the TQBoxLayout and set the
widget's stretch factor. (The stretch factor is along the row of
boxes.)
\i addSpacing() to create an empty box; this is one of the
functions you use to create nice and spacious dialogs. See below
for ways to set margins.
\i addStretch() to create an empty, stretchable box.
\i addLayout() to add a box containing another TQLayout to the row
and set that tqlayout's stretch factor.
\endlist
Use insertWidget(), insertSpacing(), insertStretch() or
insertLayout() to insert a box at a specified position in the
tqlayout.
TQBoxLayout also includes two margin widths:
\list
\i setMargin() sets the width of the outer border. This is the width
of the reserved space along each of the TQBoxLayout's four sides.
\i setSpacing() sets the width between neighboring boxes. (You
can use addSpacing() to get more space at a particular spot.)
\endlist
The margin defaults to 0. The spacing defaults to the same as the
margin width for a top-level tqlayout, or to the same as the tqparent
tqlayout. Both are parameters to the constructor.
To remove a widget from a tqlayout, call remove(). Calling
TQWidget::hide() on a widget also effectively removes the widget
from the tqlayout until TQWidget::show() is called.
You will almost always want to use TQVBoxLayout and TQHBoxLayout
rather than TQBoxLayout because of their convenient constructors.
\sa TQGrid \link tqlayout.html Layout Overview \endlink
*/
/*!
\enum TQBoxLayout::Direction
This type is used to determine the direction of a box tqlayout.
\value LeftToRight Horizontal, from left to right
\value RightToLeft Horizontal, from right to left
\value TopToBottom Vertical, from top to bottom
\value Down The same as \c TopToBottom
\value BottomToTop Vertical, from bottom to top
\value Up The same as \c BottomToTop
*/
static inline bool horz( TQBoxLayout::Direction dir )
{
return dir == TQBoxLayout::RightToLeft || dir == TQBoxLayout::LeftToRight;
}
/*!
Constructs a new TQBoxLayout with direction \a d and main widget \a
tqparent. \a tqparent may not be 0.
The \a margin is the number of pixels between the edge of the
widget and its managed tqchildren. The \a spacing is the default
number of pixels between neighboring tqchildren. If \a spacing is -1
the value of \a margin is used for \a spacing.
\a name is the internal object name.
\sa direction()
*/
TQBoxLayout::TQBoxLayout( TQWidget *tqparent, Direction d,
int margin, int spacing, const char *name )
: TQLayout( tqparent, margin, spacing, name )
{
data = new TQBoxLayoutData;
dir = d;
setSupportsMargin( TRUE );
}
/*!
Constructs a new TQBoxLayout called \a name, with direction \a d,
and inserts it into \a parentLayout.
The \a spacing is the default number of pixels between neighboring
tqchildren. If \a spacing is -1, the tqlayout will inherit its
tqparent's spacing().
*/
TQBoxLayout::TQBoxLayout( TQLayout *parentLayout, Direction d, int spacing,
const char *name )
: TQLayout( parentLayout, spacing, name )
{
data = new TQBoxLayoutData;
dir = d;
setSupportsMargin( TRUE );
}
/*!
Constructs a new TQBoxLayout called \a name, with direction \a d.
If \a spacing is -1, the tqlayout will inherit its tqparent's
spacing(); otherwise \a spacing is used.
You must insert this box into another tqlayout.
*/
TQBoxLayout::TQBoxLayout( Direction d, int spacing, const char *name )
: TQLayout( spacing, name )
{
data = new TQBoxLayoutData;
dir = d;
setSupportsMargin( TRUE );
}
/*!
Destroys this box tqlayout.
The tqlayout's widgets aren't destroyed.
*/
TQBoxLayout::~TQBoxLayout()
{
delete data;
}
/*!
Returns the preferred size of this box tqlayout.
*/
TQSize TQBoxLayout::sizeHint() const
{
if ( data->dirty ) {
TQBoxLayout *that = (TQBoxLayout*)this;
that->setupGeom();
}
return data->sizeHint + TQSize( 2 * margin(), 2 * margin() );
}
/*!
Returns the minimum size needed by this box tqlayout.
*/
TQSize TQBoxLayout::tqminimumSize() const
{
if ( data->dirty ) {
TQBoxLayout *that = (TQBoxLayout*)this;
that->setupGeom();
}
return data->minSize + TQSize( 2 * margin(), 2 * margin() );
}
/*!
Returns the maximum size needed by this box tqlayout.
*/
TQSize TQBoxLayout::tqmaximumSize() const
{
if ( data->dirty ) {
TQBoxLayout *that = (TQBoxLayout*)this;
that->setupGeom();
}
TQSize s = ( data->maxSize + TQSize(2 * margin(), 2 * margin()) )
.boundedTo(TQSize(TQLAYOUTSIZE_MAX, TQLAYOUTSIZE_MAX));
if ( tqalignment() & TQt::AlignHorizontal_Mask )
s.setWidth( TQLAYOUTSIZE_MAX );
if ( tqalignment() & TQt::AlignVertical_Mask )
s.setHeight( TQLAYOUTSIZE_MAX );
return s;
}
/*!
Returns TRUE if this tqlayout's preferred height depends on its width;
otherwise returns FALSE.
*/
bool TQBoxLayout::hasHeightForWidth() const
{
if ( data->dirty ) {
TQBoxLayout *that = (TQBoxLayout*)this;
that->setupGeom();
}
return data->hasHfw;
}
/*!
Returns the tqlayout's preferred height when it is \a w pixels wide.
*/
int TQBoxLayout::heightForWidth( int w ) const
{
if ( !hasHeightForWidth() )
return -1;
w -= 2 * margin();
if ( w != data->hfwWidth ) {
TQBoxLayout *that = (TQBoxLayout*)this;
that->calcHfw( w );
}
return data->hfwHeight + 2 * margin();
}
/*! \internal */
int TQBoxLayout::minimumHeightForWidth( int w ) const
{
(void) heightForWidth( w );
return data->hasHfw ? (data->hfwMinHeight + 2 * margin() ) : -1;
}
/*!
Resets cached information.
*/
void TQBoxLayout::tqinvalidate()
{
TQLayout::tqinvalidate();
data->setDirty();
}
/*!
\reimp
*/
int TQBoxLayout::count() const {
return data->list.count();
}
/*!
\reimp
*/
TQLayoutItem* TQBoxLayout::itemAt(int index) const {
return index >= 0 && index < data->list.count() ? data->list.at(index)->item : 0;
}
/*!
\reimp
*/
TQLayoutItem* TQBoxLayout::takeAt(int index) {
if (index < 0 || index >= data->list.count())
return 0;
TQBoxLayoutItem *b = data->list.take(index);
TQLayoutItem *item = b->item;
b->item = 0;
delete b;
invalidate();
return item;
}
/*!
\reimp
*/
// TQLayoutIterator TQBoxLayout::iterator()
// {
// return TQLayoutIterator( new TQBoxLayoutIterator(data) );
// }
/*!
Returns whether this tqlayout can make use of more space than
sizeHint(). A value of \c Vertical or \c Horizontal means that it wants
to grow in only one dimension, whereas \c BothDirections means that
it wants to grow in both dimensions.
*/
TQ_SPExpandData TQBoxLayout::expandingDirections() const
{
if ( data->dirty ) {
TQBoxLayout *that = (TQBoxLayout*)this;
that->setupGeom();
}
return data->expanding;
}
/*!
Resizes managed widgets within the rectangle \a r.
*/
void TQBoxLayout::setGeometry( const TQRect &r )
{
if ( !data->geomArray || r != tqgeometry() ) {
TQLayout::setGeometry( r );
if ( !data->geomArray )
setupGeom();
TQRect cr = tqalignment() ? alignmentRect( r ) : r;
TQRect s( cr.x() + margin(), cr.y() + margin(),
cr.width() - 2 * margin(), cr.height() - 2 * margin() );
TQMemArray<TQLayoutStruct> a = *data->geomArray;
int pos = horz( dir ) ? s.x() : s.y();
int space = horz( dir ) ? s.width() : s.height();
int n = a.count();
if ( data->hasHfw && !horz(dir) ) {
for ( int i = 0; i < n; i++ ) {
TQBoxLayoutItem *box = data->list.at( i );
if ( box->item->hasHeightForWidth() )
a[i].sizeHint = a[i].tqminimumSize =
box->item->heightForWidth( s.width() );
}
}
Direction visualDir = dir;
if ( TQApplication::reverseLayout() ) {
if ( dir == LeftToRight )
visualDir = RightToLeft;
else if ( dir == RightToLeft )
visualDir = LeftToRight;
}
qGeomCalc( a, 0, n, pos, space, spacing() );
for ( int i = 0; i < n; i++ ) {
TQBoxLayoutItem *box = data->list.at( i );
switch ( visualDir ) {
case LeftToRight:
box->item->setGeometry( TQRect(a[i].pos, s.y(),
a[i].size, s.height()) );
break;
case RightToLeft:
box->item->setGeometry( TQRect(s.left() + s.right()
- a[i].pos - a[i].size + 1, s.y(),
a[i].size, s.height()) );
break;
case TopToBottom:
box->item->setGeometry( TQRect(s.x(), a[i].pos,
s.width(), a[i].size) );
break;
case BottomToTop:
box->item->setGeometry( TQRect(s.x(), s.top() + s.bottom()
- a[i].pos - a[i].size + 1,
s.width(), a[i].size) );
}
}
}
}
/*!
Adds \a item to the end of this box tqlayout.
*/
void TQBoxLayout::addItem( QLayoutItem *item )
{
TQBoxLayoutItem *it = new TQBoxLayoutItem( static_cast<TQLayoutItem*>(item) );
data->list.append( it );
tqinvalidate();
}
/*!
Inserts \a item into this box tqlayout at position \a index. If \a
index is negative, the item is added at the end.
\warning Does not call TQLayout::insertChildLayout() if \a item is
a TQLayout.
\sa addItem(), tqfindWidget()
*/
void TQBoxLayout::insertItem( int index, TQLayoutItem *item )
{
if ( index < 0 ) // append
index = data->list.count();
TQBoxLayoutItem *it = new TQBoxLayoutItem( item );
data->list.insert( index, it );
tqinvalidate();
}
/*!
Inserts a non-stretchable space at position \a index, with size \a
size. If \a index is negative the space is added at the end.
The box tqlayout has default margin and spacing. This function adds
additional space.
\sa insertStretch()
*/
void TQBoxLayout::insertSpacing( int index, int size )
{
if ( index < 0 ) // append
index = data->list.count();
// hack in TQGridLayoutData: spacers do not get insideSpacing
TQLayoutItem *b;
if ( horz( dir ) )
b = TQT_TQLAYOUTITEM(new TQSpacerItem( size, 0, TQSizePolicy::Fixed,
TQSizePolicy::Minimum ));
else
b = TQT_TQLAYOUTITEM(new TQSpacerItem( 0, size, TQSizePolicy::Minimum,
TQSizePolicy::Fixed ));
TQBoxLayoutItem *it = new TQBoxLayoutItem( b );
it->magic = TRUE;
data->list.insert( index, it );
tqinvalidate();
}
/*!
Inserts a stretchable space at position \a index, with zero
minimum size and stretch factor \a stretch. If \a index is
negative the space is added at the end.
\sa insertSpacing()
*/
void TQBoxLayout::insertStretch( int index, int stretch )
{
if ( index < 0 ) // append
index = data->list.count();
// hack in TQGridLayoutData: spacers do not get insideSpacing
TQLayoutItem *b;
if ( horz( dir ) )
b = TQT_TQLAYOUTITEM(new TQSpacerItem( 0, 0, TQSizePolicy::Expanding,
TQSizePolicy::Minimum ));
else
b = TQT_TQLAYOUTITEM(new TQSpacerItem( 0, 0, TQSizePolicy::Minimum,
TQSizePolicy::Expanding ));
TQBoxLayoutItem *it = new TQBoxLayoutItem( b, stretch );
it->magic = TRUE;
data->list.insert( index, it );
tqinvalidate();
}
/*!
Inserts \a tqlayout at position \a index, with stretch factor \a
stretch. If \a index is negative, the tqlayout is added at the end.
\a tqlayout becomes a child of the box tqlayout.
\sa setAutoAdd(), insertWidget(), insertSpacing()
*/
void TQBoxLayout::insertLayout( int index, TQLayout *tqlayout, int stretch )
{
if ( index < 0 ) // append
index = data->list.count();
addChildLayout( tqlayout );
TQBoxLayoutItem *it = new TQBoxLayoutItem( TQT_TQLAYOUTITEM(tqlayout), stretch );
data->list.insert( index, it );
tqinvalidate();
}
/*!
Inserts \a widget at position \a index, with stretch factor \a
stretch and tqalignment \a tqalignment. If \a index is negative, the
widget is added at the end.
The stretch factor applies only in the \link direction() direction
\endlink of the TQBoxLayout, and is relative to the other boxes and
widgets in this TQBoxLayout. Widgets and boxes with higher stretch
factors grow more.
If the stretch factor is 0 and nothing else in the TQBoxLayout has
a stretch factor greater than zero, the space is distributed
according to the TQWidget:sizePolicy() of each widget that's
involved.
Alignment is specified by \a tqalignment, which is a bitwise OR of
\l TQt::AlignmentFlags values. The default tqalignment is 0, which
means that the widget fills the entire cell.
From TQt 3.0, the \a tqalignment parameter is interpreted more
aggressively than in previous versions of TQt. A non-default
tqalignment now indicates that the widget should not grow to fill
the available space, but should be sized according to sizeHint().
\sa setAutoAdd(), insertLayout(), insertSpacing()
*/
void TQBoxLayout::insertWidget( int index, TQWidget *widget, int stretch,
int tqalignment )
{
if ( !checkWidget(this, widget) )
return;
if ( index < 0 ) // append
index = data->list.count();
TQWidgetItem *b = new TQWidgetItem( widget );
b->tqsetAlignment( tqalignment );
TQBoxLayoutItem *it = new TQBoxLayoutItem( b, stretch );
data->list.insert( index, it );
tqinvalidate();
}
/*!
Adds a non-stretchable space with size \a size to the end of this
box tqlayout. TQBoxLayout provides default margin and spacing. This
function adds additional space.
\sa insertSpacing(), addStretch()
*/
void TQBoxLayout::addSpacing( int size )
{
insertSpacing( -1, size );
}
/*!
Adds a stretchable space with zero minimum size and stretch factor
\a stretch to the end of this box tqlayout.
\sa addSpacing()
*/
void TQBoxLayout::addStretch( int stretch )
{
insertStretch( -1, stretch );
}
/*!
Adds \a widget to the end of this box tqlayout, with a stretch
factor of \a stretch and tqalignment \a tqalignment.
The stretch factor applies only in the \link direction() direction
\endlink of the TQBoxLayout, and is relative to the other boxes and
widgets in this TQBoxLayout. Widgets and boxes with higher stretch
factors grow more.
If the stretch factor is 0 and nothing else in the TQBoxLayout has
a stretch factor greater than zero, the space is distributed
according to the TQWidget:sizePolicy() of each widget that's
involved.
Alignment is specified by \a tqalignment which is a bitwise OR of \l
TQt::AlignmentFlags values. The default tqalignment is 0, which means
that the widget fills the entire cell.
From TQt 3.0, the \a tqalignment parameter is interpreted more
aggressively than in previous versions of TQt. A non-default
tqalignment now indicates that the widget should not grow to fill
the available space, but should be sized according to sizeHint().
\sa insertWidget(), setAutoAdd(), addLayout(), addSpacing()
*/
void TQBoxLayout::addWidget( TQWidget *widget, int stretch,
int tqalignment )
{
insertWidget( -1, widget, stretch, tqalignment );
}
/*!
Adds \a tqlayout to the end of the box, with serial stretch factor
\a stretch.
When a tqlayout is constructed with another tqlayout as its tqparent,
you don't need to call addLayout(); the child tqlayout is
automatically added to the tqparent tqlayout as it is constructed.
\sa insertLayout(), setAutoAdd(), addWidget(), addSpacing()
*/
void TQBoxLayout::addLayout( TQLayout *tqlayout, int stretch )
{
insertLayout( -1, tqlayout, stretch );
}
/*!
Limits the perpendicular dimension of the box (e.g. height if the
box is LeftToRight) to a minimum of \a size. Other constraints may
increase the limit.
*/
void TQBoxLayout::addStrut( int size )
{
TQLayoutItem *b;
if ( horz( dir ) )
b = TQT_TQLAYOUTITEM(new TQSpacerItem( 0, size, TQSizePolicy::Fixed,
TQSizePolicy::Minimum ));
else
b = TQT_TQLAYOUTITEM(new TQSpacerItem( size, 0, TQSizePolicy::Minimum,
TQSizePolicy::Fixed ));
TQBoxLayoutItem *it = new TQBoxLayoutItem( b );
it->magic = TRUE;
data->list.append( it );
tqinvalidate();
}
/*!
Searches for widget \a w in this tqlayout (not including child
layouts).
Returns the index of \a w, or -1 if \a w is not found.
*/
int TQBoxLayout::tqfindWidget( TQWidget* w )
{
const int n = data->list.count();
for ( int i = 0; i < n; i++ ) {
if ( data->list.at(i)->item->widget() == w )
return i;
}
return -1;
}
/*!
Sets the stretch factor for widget \a w to \a stretch and returns
TRUE if \a w is found in this tqlayout (not including child
layouts); otherwise returns FALSE.
*/
bool TQBoxLayout::setStretchFactor( TQWidget *w, int stretch )
{
TQPtrListIterator<TQBoxLayoutItem> it( data->list );
TQBoxLayoutItem *box;
while ( (box=it.current()) != 0 ) {
++it;
if ( box->item->widget() == w ) {
box->stretch = stretch;
tqinvalidate();
return TRUE;
}
}
return FALSE;
}
/*!
\overload
Sets the stretch factor for the tqlayout \a l to \a stretch and
returns TRUE if \a l is found in this tqlayout (not including child
layouts); otherwise returns FALSE.
*/
bool TQBoxLayout::setStretchFactor( TQLayout *l, int stretch )
{
TQPtrListIterator<TQBoxLayoutItem> it( data->list );
TQBoxLayoutItem *box;
while ( (box=it.current()) != 0 ) {
++it;
if ( box->item->tqlayout() == l ) {
box->stretch = stretch;
tqinvalidate();
return TRUE;
}
}
return FALSE;
}
/*!
Sets the direction of this tqlayout to \a direction.
*/
void TQBoxLayout::setDirection( Direction direction )
{
if ( dir == direction )
return;
if ( horz(dir) != horz(direction) ) {
//swap around the spacers (the "magic" bits)
//#### a bit yucky, knows too much.
//#### probably best to add access functions to tqspacerItem
//#### or even a TQSpacerItem::flip()
TQPtrListIterator<TQBoxLayoutItem> it( data->list );
TQBoxLayoutItem *box;
while ( (box=it.current()) != 0 ) {
++it;
if ( box->magic ) {
TQSpacerItem *sp = box->item->tqspacerItem();
if ( sp ) {
if ( sp->expandingDirections() == TQSizePolicy::NoDirection ) {
//spacing or strut
TQSize s = sp->sizeHint();
sp->changeSize( s.height(), s.width(),
horz(direction) ? TQSizePolicy::Fixed:TQSizePolicy::Minimum,
horz(direction) ? TQSizePolicy::Minimum:TQSizePolicy::Fixed );
} else {
//stretch
if ( horz(direction) )
sp->changeSize( 0, 0, TQSizePolicy::Expanding,
TQSizePolicy::Minimum );
else
sp->changeSize( 0, 0, TQSizePolicy::Minimum,
TQSizePolicy::Expanding );
}
}
}
}
}
dir = direction;
tqinvalidate();
if ( mainWidget() ) {
TQEvent *lh = new TQEvent( TQEvent::LayoutHint );
TQApplication::postEvent( mainWidget(), lh );
}
}
/*
Initializes the data structure needed by qGeomCalc and
recalculates max/min and size hint.
*/
void TQBoxLayout::setupGeom()
{
if ( !data->dirty )
return;
int maxw = horz( dir ) ? 0 : TQLAYOUTSIZE_MAX;
int maxh = horz( dir ) ? TQLAYOUTSIZE_MAX : 0;
int minw = 0;
int minh = 0;
int hintw = 0;
int hinth = 0;
bool horexp = FALSE;
bool verexp = FALSE;
data->hasHfw = FALSE;
delete data->geomArray;
int n = data->list.count();
data->geomArray = new TQMemArray<TQLayoutStruct>( n );
TQMemArray<TQLayoutStruct>& a = *data->geomArray;
bool first = TRUE;
for ( int i = 0; i < n; i++ ) {
TQBoxLayoutItem *box = data->list.at( i );
TQSize max = box->item->maximumSize();
TQSize min = box->item->minimumSize();
TQSize hint = box->item->sizeHint();
TQ_SPExpandData exp = box->item->expandingDirections();
bool empty = box->item->isEmpty();
// space before non-empties, except the first:
int space = ( empty || first ) ? 0 : spacing();
bool ignore = empty && box->item->widget(); // ignore hidden widgets
if ( horz(dir) ) {
bool expand = exp & TQSizePolicy::Horizontally || box->stretch > 0;
horexp = horexp || expand;
maxw += max.width() + space;
minw += min.width() + space;
hintw += hint.width() + space;
if ( !ignore )
qMaxExpCalc( maxh, verexp,
max.height(), exp & TQSizePolicy::Vertically );
minh = TQMAX( minh, min.height() );
hinth = TQMAX( hinth, hint.height() );
a[i].sizeHint = hint.width();
a[i].tqmaximumSize = max.width();
a[i].tqminimumSize = min.width();
a[i].expansive = expand;
a[i].stretch = box->stretch ? box->stretch : box->hStretch();
} else {
bool expand = ( exp & TQSizePolicy::Vertically || box->stretch > 0 );
verexp = verexp || expand;
maxh += max.height() + space;
minh += min.height() + space;
hinth += hint.height() + space;
if ( !ignore )
qMaxExpCalc( maxw, horexp,
max.width(), exp & TQSizePolicy::Horizontally );
minw = TQMAX( minw, min.width() );
hintw = TQMAX( hintw, hint.width() );
a[i].sizeHint = hint.height();
a[i].tqmaximumSize = max.height();
a[i].tqminimumSize = min.height();
a[i].expansive = expand;
a[i].stretch = box->stretch ? box->stretch : box->vStretch();
}
a[i].empty = empty;
data->hasHfw = data->hasHfw || box->item->hasHeightForWidth();
first = first && empty;
}
data->minSize = TQSize( minw, minh );
data->maxSize = TQSize( maxw, maxh ).expandedTo( data->minSize );
data->expanding = (TQ_SPExpandData)
( (horexp ? TQSizePolicy::Horizontally : 0)
| (verexp ? TQSizePolicy::Vertically : 0) );
data->sizeHint = TQSize( hintw, hinth )
.expandedTo( data->minSize )
.boundedTo( data->maxSize );
data->dirty = FALSE;
}
/*
Calculates and stores the preferred height given the width \a w.
*/
void TQBoxLayout::calcHfw( int w )
{
int h = 0;
int mh = 0;
if ( horz(dir) ) {
TQMemArray<TQLayoutStruct> &a = *data->geomArray;
int n = a.count();
qGeomCalc( a, 0, n, 0, w, spacing() );
for ( int i = 0; i < n; i++ ) {
TQBoxLayoutItem *box = data->list.at(i);
h = TQMAX( h, box->hfw(a[i].size) );
mh = TQMAX( mh, box->mhfw(a[i].size) );
}
} else {
TQPtrListIterator<TQBoxLayoutItem> it( data->list );
TQBoxLayoutItem *box;
bool first = TRUE;
while ( (box = it.current()) != 0 ) {
++it;
bool empty = box->item->isEmpty();
h += box->hfw( w );
mh += box->mhfw( w );
if ( !first && !empty ) {
h += spacing();
mh += spacing();
}
first = first && empty;
}
}
data->hfwWidth = w;
data->hfwHeight = h;
data->hfwMinHeight = mh;
}
/*!
\fn TQBoxLayout::Direction TQBoxLayout::direction() const
Returns the direction of the box. addWidget() and addSpacing()
work in this direction; the stretch stretches in this direction.
\sa TQBoxLayout::Direction addWidget() addSpacing()
*/
/*!
\class TQHBoxLayout
\brief The TQHBoxLayout class lines up widgets horizontally.
\ingroup geomanagement
\ingroup appearance
\mainclass
This class is used to construct horizontal box tqlayout objects. See
\l TQBoxLayout for more details.
The simplest use of the class is like this:
\code
TQBoxLayout * l = new TQHBoxLayout( widget );
l->setAutoAdd( TRUE );
new TQSomeWidget( widget );
new TQSomeOtherWidget( widget );
new TQAnotherWidget( widget );
\endcode
or like this:
\code
TQBoxLayout * l = new TQHBoxLayout( widget );
l->addWidget( existingChildOfWidget );
l->addWidget( anotherChildOfWidget );
\endcode
\img qhboxtqlayout.png TQHBox
\sa TQVBoxLayout TQGridLayout
\link tqlayout.html the Layout overview \endlink
*/
/*!
Constructs a new top-level horizontal box called \a name, with
tqparent \a tqparent.
The \a margin is the number of pixels between the edge of the
widget and its managed tqchildren. The \a spacing is the default
number of pixels between neighboring tqchildren. If \a spacing is -1
the value of \a margin is used for \a spacing.
*/
TQHBoxLayout::TQHBoxLayout( TQWidget *tqparent, int margin,
int spacing, const char *name )
: TQBoxLayout( tqparent, LeftToRight, margin, spacing, name )
{
}
/*!
Constructs a new horizontal box called name \a name and adds it to
\a parentLayout.
The \a spacing is the default number of pixels between neighboring
tqchildren. If \a spacing is -1, this TQHBoxLayout will inherit its
tqparent's spacing().
*/
TQHBoxLayout::TQHBoxLayout( TQLayout *parentLayout, int spacing,
const char *name )
: TQBoxLayout( parentLayout, LeftToRight, spacing, name )
{
}
/*!
Constructs a new horizontal box called name \a name. You must add
it to another tqlayout.
The \a spacing is the default number of pixels between neighboring
tqchildren. If \a spacing is -1, this TQHBoxLayout will inherit its
tqparent's spacing().
*/
TQHBoxLayout::TQHBoxLayout( int spacing, const char *name )
: TQBoxLayout( LeftToRight, spacing, name )
{
}
/*!
Destroys this box tqlayout.
The tqlayout's widgets aren't destroyed.
*/
TQHBoxLayout::~TQHBoxLayout()
{
}
/*!
\class TQVBoxLayout
\brief The TQVBoxLayout class lines up widgets vertically.
\ingroup geomanagement
\ingroup appearance
\mainclass
This class is used to construct vertical box tqlayout objects. See
TQBoxLayout for more details.
The simplest use of the class is like this:
\code
TQBoxLayout * l = new TQVBoxLayout( widget );
l->addWidget( aWidget );
l->addWidget( anotherWidget );
\endcode
\img qvboxtqlayout.png TQVBox
\sa TQHBoxLayout TQGridLayout \link tqlayout.html the Layout overview \endlink
*/
/*!
Constructs a new top-level vertical box called \a name, with
tqparent \a tqparent.
The \a margin is the number of pixels between the edge of the
widget and its managed tqchildren. The \a spacing is the default
number of pixels between neighboring tqchildren. If \a spacing is -1
the value of \a margin is used for \a spacing.
*/
TQVBoxLayout::TQVBoxLayout( TQWidget *tqparent, int margin, int spacing,
const char *name )
: TQBoxLayout( tqparent, TopToBottom, margin, spacing, name )
{
}
/*!
Constructs a new vertical box called name \a name and adds it to
\a parentLayout.
The \a spacing is the default number of pixels between neighboring
tqchildren. If \a spacing is -1, this TQVBoxLayout will inherit its
tqparent's spacing().
*/
TQVBoxLayout::TQVBoxLayout( TQLayout *parentLayout, int spacing,
const char *name )
: TQBoxLayout( parentLayout, TopToBottom, spacing, name )
{
}
/*!
Constructs a new vertical box called name \a name. You must add
it to another tqlayout.
The \a spacing is the default number of pixels between neighboring
tqchildren. If \a spacing is -1, this TQVBoxLayout will inherit its
tqparent's spacing().
*/
TQVBoxLayout::TQVBoxLayout( int spacing, const char *name )
: TQBoxLayout( TopToBottom, spacing, name )
{
}
/*!
Destroys this box tqlayout.
The tqlayout's widgets aren't destroyed.
*/
TQVBoxLayout::~TQVBoxLayout()
{
}
TQBoxLayout *TQBoxLayout::createTmpCopy()
{
TQBoxLayout *bl = new TQBoxLayout( direction() );
delete bl->data;
bl->data = data;
return bl;
}
#endif // TQT_NO_LAYOUT
View Git Blame Copy Permalink