Question

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

#include <qwidgetstack.h>

继承了QFrame。

所有成员函数的列表。

公有成员

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

公有槽

• void raiseWidget ( intid )
• 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, constchar*name = 0 )

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

QWidgetStack::~QWidgetStack ()

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

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

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

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

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

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

int QWidgetStack::addWidget ( QWidget*w, intid = -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 ( intid ) [槽]

升起标识为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 ( intid ) const

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

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