Qtopia Home - Classes - Hierachy - Annotated - Functions - Licenses - Reference

QWidgetStack Class Reference

The QWidgetStack class provides a stack of widgets, where the user can see only the top widget. More...

#include <qwidgetstack.h>

Inherits QFrame.

Inherited by MediaPlayer.

List of all member functions.

Public Members

• QWidgetStack ( QWidget * parent = 0, const char * name = 0 )
• ~QWidgetStack ()
• void addWidget ( QWidget * w, int id )
• void removeWidget ( QWidget * w )
• QWidget * widget ( int id ) const
• int id ( QWidget * widget ) const
• QWidget * visibleWidget () const

Public Slots

• void raiseWidget ( int id )
• void raiseWidget ( QWidget * w )

Signals

• void aboutToShow ( int )
• void aboutToShow ( QWidget * )

Protected Members

• virtual void setChildGeometries ()

Detailed Description

The QWidgetStack class provides a stack of widgets, where the user can see only the top widget.

The application programmer can move any widget to the top of the stack at any time using the slot raiseWidget(), and add or remove widgets using addWidget() and removeWidget().

visibleWidget() is the get equivalent of raiseWidget(); it returns a pointer to the widget that is currently on the top of the stack.

QWidgetStack also provides the ability to manipulate widgets through application-specfied integer IDs, and to translate from widget pointers to IDs using id() and from IDs to widget pointers using widget(). These numeric IDs have and unique (per QWidgetStack, not globally) and cannot be -1, but apart from that QWidgetStack does not attach any meaning to them.

The default widget stack is frame-less and propagates its font and palette to all its children, but you can use the usual QFrame functions (like setFrameStyle()) to add a frame, and use setFontPropagation() and setPalettePropagation() to change the propagation style.

Finally, QWidgetStack provides a signal, aboutToShow(), which is emitted just before a managed widget is shown.

See also QTabDialog, QTabBar, and QFrame.

Member Function Documentation

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

QWidgetStack::~QWidgetStack ()

void QWidgetStack::aboutToShow ( int ) [signal]

This signal is emitted just before a managed widget is shown, if that managed widget has a non-zero ID. The argument is the numeric ID of the widget.

void QWidgetStack::aboutToShow ( QWidget * ) [signal]

This signal is emitted just before a managed widget is shown. The argument is a pointer to the widget.

void QWidgetStack::addWidget ( QWidget * w, int id )

If w is not a child of this, QWidgetStack moves it using reparent().

Note that the added children are initially hidden. After you have added the widgets you want to the stack, you may want to call raiseWidget() on one of them.

int QWidgetStack::id ( QWidget * widget ) const

See also widget() and addWidget().

void QWidgetStack::raiseWidget ( int id ) [slot]

See also visibleWidget().

void QWidgetStack::raiseWidget ( QWidget * w ) [slot]

void QWidgetStack::removeWidget ( QWidget * w )

See also visibleWidget() and raiseWidget().

void QWidgetStack::setChildGeometries () [virtual protected]

QWidget * QWidgetStack::visibleWidget () const

See also aboutToShow(), id(), and raiseWidget().

QWidget * QWidgetStack::widget ( int id ) const

See also id() and addWidget().

This file is part of the Qtopia platform, copyright © 1995-2005 Trolltech, all rights reserved.