<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
< html >
< head >
< meta http-equiv = "Content-Type" content = "text/html; charset=ISO-8859-1" >
< title > TQWidgetStack Class< / title >
< style type = "text/css" > < ! - -
fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; }
-->< / style >
< / head >
< body >
< table border = "0" cellpadding = "0" cellspacing = "0" width = "100%" >
< tr bgcolor = "#E5E5E5" >
< td valign = center >
< a href = "index.html" >
< font color = "#004faf" > Home< / font > < / a >
| < a href = "classes.html" >
< font color = "#004faf" > All Classes< / font > < / a >
| < a href = "mainclasses.html" >
< font color = "#004faf" > Main Classes< / font > < / a >
| < a href = "annotated.html" >
< font color = "#004faf" > Annotated< / font > < / a >
| < a href = "groups.html" >
< font color = "#004faf" > Grouped Classes< / font > < / a >
| < a href = "functions.html" >
< font color = "#004faf" > Functions< / font > < / a >
< / td >
< td align = "right" valign = "center" > < img src = "logo32.png" align = "right" width = "64" height = "32" border = "0" > < / td > < / tr > < / table > < h1 align = center > TQWidgetStack Class Reference< / h1 >
< p > The TQWidgetStack class provides a stack of widgets of which
only the top widget is user-visible.
< a href = "#details" > More...< / a >
< p > < tt > #include < < a href = "tqwidgetstack-h.html" > tqwidgetstack.h< / a > > < / tt >
< p > Inherits < a href = "tqframe.html" > TQFrame< / a > .
< p > < a href = "tqwidgetstack-members.html" > List of all member functions.< / a >
< h2 > Public Members< / h2 >
< ul >
< li class = fn > < a href = "#TQWidgetStack" > < b > TQWidgetStack< / b > < / a > ( TQWidget * parent = 0, const char * name = 0 )< / li >
< li class = fn > < a href = "#TQWidgetStack-2" > < b > TQWidgetStack< / b > < / a > ( TQWidget * parent, const char * name, WFlags f )< / li >
< li class = fn > < a href = "#~TQWidgetStack" > < b > ~TQWidgetStack< / b > < / a > ()< / li >
< li class = fn > int < a href = "#addWidget" > < b > addWidget< / b > < / a > ( TQWidget * w, int id = -1 )< / li >
< li class = fn > void < a href = "#removeWidget" > < b > removeWidget< / b > < / a > ( TQWidget * w )< / li >
< li class = fn > TQWidget * < a href = "#widget" > < b > widget< / b > < / a > ( int id ) const< / li >
< li class = fn > int < a href = "#id" > < b > id< / b > < / a > ( TQWidget * widget ) const< / li >
< li class = fn > TQWidget * < a href = "#visibleWidget" > < b > visibleWidget< / b > < / a > () const< / li >
< / ul >
< h2 > Public Slots< / h2 >
< ul >
< li class = fn > void < a href = "#raiseWidget" > < b > raiseWidget< / b > < / a > ( int id )< / li >
< li class = fn > void < a href = "#raiseWidget-2" > < b > raiseWidget< / b > < / a > ( TQWidget * w )< / li >
< / ul >
< h2 > Signals< / h2 >
< ul >
< li class = fn > void < a href = "#aboutToShow" > < b > aboutToShow< / b > < / a > ( int )< / li >
< li class = fn > void < a href = "#aboutToShow-2" > < b > aboutToShow< / b > < / a > ( TQWidget * )< / li >
< / ul >
< h2 > Protected Members< / h2 >
< ul >
< li class = fn > virtual void < a href = "#setChildGeometries" > < b > setChildGeometries< / b > < / a > ()< / li >
< / ul >
< hr > < a name = "details" > < / a > < h2 > Detailed Description< / h2 >
The TQWidgetStack class provides a stack of widgets of which
only the top widget is user-visible.
< p >
< p > The application programmer can move any widget to the top of the
stack at any time using < a href = "#raiseWidget" > raiseWidget< / a > (), and add or remove widgets
using < a href = "#addWidget" > addWidget< / a > () and < a href = "#removeWidget" > removeWidget< / a > (). It is not sufficient to pass
the widget stack as parent to a widget which should be inserted into
the widgetstack.
< p > < a href = "#visibleWidget" > visibleWidget< / a > () is the < em > get< / em > equivalent of raiseWidget(); it
returns a pointer to the widget that is currently at the top of
the stack.
< p > TQWidgetStack also provides the ability to manipulate widgets
through application-specified integer IDs. You can also translate
from widget pointers to IDs using < a href = "#id" > id< / a > () and from IDs to widget
pointers using < a href = "#widget" > widget< / a > (). These numeric IDs are unique (per
TQWidgetStack, not globally), but TQWidgetStack does not attach any
additional meaning to them.
< p > The default widget stack is frameless, but you can use the usual
< a href = "tqframe.html" > TQFrame< / a > functions (such as < a href = "tqframe.html#setFrameStyle" > setFrameStyle< / a > ()) to add a frame.
< p > TQWidgetStack provides a signal, < a href = "#aboutToShow" > aboutToShow< / a > (), which is emitted
just before a managed widget is shown.
< p > < p > See also < a href = "tqtabdialog.html" > TQTabDialog< / a > , < a href = "tqtabbar.html" > TQTabBar< / a > , < a href = "tqframe.html" > TQFrame< / a > , and < a href = "organizers.html" > Organizers< / a > .
< hr > < h2 > Member Function Documentation< / h2 >
< h3 class = fn > < a name = "TQWidgetStack" > < / a > TQWidgetStack::TQWidgetStack ( < a href = "tqwidget.html" > TQWidget< / a > * parent = 0, const char * name = 0 )
< / h3 >
Constructs an empty widget stack.
< p > The < em > parent< / em > and < em > name< / em > arguments are passed to the < a href = "tqframe.html" > TQFrame< / a >
constructor.
< h3 class = fn > < a name = "TQWidgetStack-2" > < / a > TQWidgetStack::TQWidgetStack ( < a href = "tqwidget.html" > TQWidget< / a > * parent, const char * name, WFlags f )
< / h3 >
Constructs an empty widget stack.
< p > The < em > parent< / em > , < em > name< / em > and < em > f< / em > arguments are passed to the < a href = "tqframe.html" > TQFrame< / a >
constructor.
< h3 class = fn > < a name = "~TQWidgetStack" > < / a > TQWidgetStack::~TQWidgetStack ()
< / h3 >
Destroys the object and frees any allocated resources.
< h3 class = fn > void < a name = "aboutToShow" > < / a > TQWidgetStack::aboutToShow ( int )< tt > [signal]< / tt >
< / h3 >
< p > This signal is emitted just before a managed widget is shown if
that managed widget has an ID != -1. The argument is the numeric
ID of the widget.
< p > If you call < a href = "#visibleWidget" > visibleWidget< / a > () in a slot connected to < a href = "#aboutToShow" > aboutToShow< / a > (),
the widget it returns is the one that is currently visible, not
the one that is about to be shown.
< h3 class = fn > void < a name = "aboutToShow-2" > < / a > TQWidgetStack::aboutToShow ( < a href = "tqwidget.html" > TQWidget< / a > * )< tt > [signal]< / tt >
< / h3 >
< p > This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
< p > This signal is emitted just before a managed widget is shown. The
argument is a pointer to the widget.
< p > If you call < a href = "#visibleWidget" > visibleWidget< / a > () in a slot connected to < a href = "#aboutToShow" > aboutToShow< / a > (),
the widget returned is the one that is currently visible, not the
one that is about to be shown.
< h3 class = fn > int < a name = "addWidget" > < / a > TQWidgetStack::addWidget ( < a href = "tqwidget.html" > TQWidget< / a > * w, int id = -1 )
< / h3 >
Adds widget < em > w< / em > to this stack of widgets, with ID < em > id< / em > .
< p > If you pass an id > = 0 this ID is used. If you pass an < em > id< / em > of
-1 (the default), the widgets will be numbered automatically. If
you pass -2 a unique negative integer will be generated. No widget
has an ID of -1. Returns the ID or -1 on failure (e.g. < em > w< / em > is 0).
< p > If you pass an id that is already used, then a unique negative
integer will be generated to prevent two widgets having the same
id.
< p > If < em > w< / em > already exists in the stack the widget will be removed first.
< p > If < em > w< / em > is not a child of this TQWidgetStack moves it using
< a href = "tqwidget.html#reparent" > reparent< / a > ().
< p > Example: < a href = "xform-example.html#x1276" > xform/xform.cpp< / a > .
< h3 class = fn > int < a name = "id" > < / a > TQWidgetStack::id ( < a href = "tqwidget.html" > TQWidget< / a > * widget ) const
< / h3 >
Returns the ID of the < em > widget< / em > . Returns -1 if < em > widget< / em > is 0 or
is not being managed by this widget stack.
< p > < p > See also < a href = "#widget" > widget< / a > () and < a href = "#addWidget" > addWidget< / a > ().
< h3 class = fn > void < a name = "raiseWidget" > < / a > TQWidgetStack::raiseWidget ( int id )< tt > [slot]< / tt >
< / h3 >
Raises the widget with ID < em > id< / em > to the top of the widget stack.
< p > < p > See also < a href = "#visibleWidget" > visibleWidget< / a > ().
< p > Example: < a href = "xform-example.html#x1277" > xform/xform.cpp< / a > .
< h3 class = fn > void < a name = "raiseWidget-2" > < / a > TQWidgetStack::raiseWidget ( < a href = "tqwidget.html" > TQWidget< / a > * w )< tt > [slot]< / tt >
< / h3 >
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
< p > Raises widget < em > w< / em > to the top of the widget stack.
< h3 class = fn > void < a name = "removeWidget" > < / a > TQWidgetStack::removeWidget ( < a href = "tqwidget.html" > TQWidget< / a > * w )
< / h3 >
Removes widget < em > w< / em > from this stack of widgets. Does not delete < em > w< / em > . If < em > w< / em > is the currently visible widget, no other widget is
substituted.
< p > < p > See also < a href = "#visibleWidget" > visibleWidget< / a > () and < a href = "#raiseWidget" > raiseWidget< / a > ().
< h3 class = fn > void < a name = "setChildGeometries" > < / a > TQWidgetStack::setChildGeometries ()< tt > [virtual protected]< / tt >
< / h3 >
Fixes up the children's geometries.
< h3 class = fn > < a href = "tqwidget.html" > TQWidget< / a > * < a name = "visibleWidget" > < / a > TQWidgetStack::visibleWidget () const
< / h3 >
Returns the currently visible widget (the one at the top of the
stack), or 0 if nothing is currently being shown.
< p > < p > See also < a href = "#aboutToShow" > aboutToShow< / a > (), < a href = "#id" > id< / a > (), and < a href = "#raiseWidget" > raiseWidget< / a > ().
< h3 class = fn > < a href = "tqwidget.html" > TQWidget< / a > * < a name = "widget" > < / a > TQWidgetStack::widget ( int id ) const
< / h3 >
Returns the widget with ID < em > id< / em > . Returns 0 if this widget stack
does not manage a widget with ID < em > id< / em > .
< p > < p > See also < a href = "#id" > id< / a > () and < a href = "#addWidget" > addWidget< / a > ().
<!-- eof -->
< hr > < p >
This file is part of the < a href = "index.html" > TQt toolkit< / a > .
Copyright © 1995-2007
< a href = "http://www.trolltech.com/" > Trolltech< / a > . All Rights Reserved.< p > < address > < hr > < div align = center >
< table width = 100% cellspacing = 0 border = 0 > < tr >
< td > Copyright © 2007
< a href = "troll.html" > Trolltech< / a > < td align = center > < a href = "trademarks.html" > Trademarks< / a >
< td align = right > < div align = right > TQt 3.3.8< / div >
< / table > < / div > < / address > < / body >
< / html >
