QWidgetStack类参考

QWidgetStack类提供了一个只有最上面的窗口部件是用户可视的窗口部件的栈。详情请见……

#include <qwidgetstack.h>

继承了QFrame。

所有成员函数的列表。

公有成员

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

公有槽

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

信号

void aboutToShow ( int )
void aboutToShow ( QWidget * )

保护成员

virtual void setChildGeometries ()

详细描述n

QWidgetStack类提供了一个只有最上面的窗口部件是用户可视的窗口部件的栈。

应用程序程序员可以在任何时候使用raiseWidget()把任何一个窗口部件移到栈顶，并且使用addWidget()和removeWidget()来添加或者移除窗口部件。

visibleWidget()是raiseWidget()的获取对应函数，它返回当前在栈顶的窗口部件的指针。

QWidgetStack也提供了通过应用程序指定的整数标识来维护这些窗口部件。你也可以使用id()来从窗口部件指针转换到标识并且使用widget()来从标识转换到窗口部件指针。这些数字标识是唯一的（每一个QWidgetStack，而不是全局的），但是QWidgetStack不会给它们添加额外的东西。

默认窗口部件栈是没有框架的，但是你可以使用通常的QFrame函数（比如setFrameStyle()）来添加一个框架。

QWidgetStack提供一个信号aboutToShow()，在一个被管理的窗口部件被显示之前，这个信号被发射。

也可以参考QTabDialog、QTabBar、QFrame和组织者。

成员函数文档

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

构造一个父对象为parent、名称为name的空窗口部件栈。

QWidgetStack::~QWidgetStack ()

销毁这个对象并且释放所有已分配的资源。

void QWidgetStack::aboutToShow ( int ) `[信号]`

如果一个被管理的窗口部件的标识不等于-1，在它被显示之前，这个信号被发射。那个参数是窗口部件的数字标识。

void QWidgetStack::aboutToShow ( QWidget * ) `[信号]`

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

在一个被管理的窗口部件被显示之前，这个信号被发射。那个参数是窗口部件的指针。

int QWidgetStack::addWidget ( QWidget * w, int id = -1 )

把窗口部件w添加到这个窗口部件栈中，标识为id。

如果你传递一个id >= 0，这个标识就被使用。如果你传递一个-1的标识（默认），这个窗口部件将会被自动标识。如果你传递一个-1，一个负整数将被生成。没有窗口部件有-1的标识。

如果w不是这个QWidgetStack的子对象，QWidgetStack会使用reparent()来移动它。

实例：xform/xform.cpp。

int QWidgetStack::id ( QWidget * widget ) const

返回widget的标识，如果widget为0或者不被这个窗口部件栈管理，这个函数返回-1。

也可以参考widget()和addWidget()。

void QWidgetStack::raiseWidget ( int id ) `[槽]`

升起标识为id的窗口部件到这个窗口部件栈的栈顶。

也可以参考visibleWidget()。

实例：xform/xform.cpp。

void QWidgetStack::raiseWidget ( QWidget * w ) `[槽]`

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

升起窗口部件w到这个窗口部件栈的栈顶。

void QWidgetStack::removeWidget ( QWidget * w )

从窗口部件栈中移除窗口部件w。不删除w。如果w为当前可视窗口部件，没有其它窗口部件会替代的。

也可以参考visibleWidget()和raiseWidget()。

void QWidgetStack::setChildGeometries () `[虚保护]`

安排子窗口的几何形状。

QWidget * QWidgetStack::visibleWidget () const

返回当前可视窗口部件的指针（栈顶的那一个），或者如果当前没有被显示的，返回0。

也可以参考aboutToShow()、id()和raiseWidget()。

QWidget * QWidgetStack::widget ( int id ) const

返回标识为id的窗口部件。如果这个窗口部件栈不管理标识为id的窗口部件，这个函数返回0。

也可以参考id()和addWidget()。

Trademarks

译者:Cavendish

Qt 3.0.5版