Eneboo - Documentación para desarrolladores
|
The QWidgetStack class provides a stack of widgets of which only the top widget is user-visible. Más...
#include <qwidgetstack.h>
The QWidgetStack class provides a stack of widgets of which only the top widget is user-visible.
The application programmer can move any widget to the top of the stack at any time using raiseWidget(), and add or remove widgets using addWidget() and removeWidget(). It is not sufficient to pass the widget stack as parent to a widget which should be inserted into the widgetstack.
visibleWidget() is the get equivalent of raiseWidget(); it returns a pointer to the widget that is currently at the top of the stack.
QWidgetStack also provides the ability to manipulate widgets through application-specified integer IDs. You can also translate from widget pointers to IDs using id() and from IDs to widget pointers using widget(). These numeric IDs are unique (per QWidgetStack, not globally), but QWidgetStack does not attach any additional meaning to them.
The default widget stack is frameless, but you can use the usual QFrame functions (such as setFrameStyle()) to add a frame.
QWidgetStack provides a signal, aboutToShow(), which is emitted just before a managed widget is shown.
QWidgetStack::QWidgetStack | ( | QWidget * | parent = 0 , |
const char * | name = 0 |
||
) |
Constructs an empty widget stack.
The parent and name arguments are passed to the QFrame constructor.
Constructs an empty widget stack.
The parent, name and f arguments are passed to the QFrame constructor.
QWidgetStack::~QWidgetStack | ( | ) |
Destroys the object and frees any allocated resources.
QWidgetStack::QWidgetStack | ( | QWidget * | parent = 0 , |
const char * | name = 0 |
||
) |
QWidgetStack::~QWidgetStack | ( | ) |
void QWidgetStack::aboutToShow | ( | int | t0 | ) | [signal] |
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.
If you call visibleWidget() in a slot connected to aboutToShow(), the widget it returns is the one that is currently visible, not the one that is about to be shown.
void QWidgetStack::aboutToShow | ( | QWidget * | t0 | ) | [signal] |
Esta es una función miembro sobrecargada que se suministra por conveniencia. Difiere de la anterior función solamente en los argumentos que acepta. This signal is emitted just before a managed widget is shown. The argument is a pointer to the widget.
If you call visibleWidget() in a slot connected to aboutToShow(), the widget returned is the one that is currently visible, not the one that is about to be shown.
void QWidgetStack::aboutToShow | ( | int | ) | [signal] |
void QWidgetStack::aboutToShow | ( | QWidget * | ) | [signal] |
Adds widget w to this stack of widgets, with ID id.
If you pass an id >= 0 this ID is used. If you pass an id 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. w is 0).
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.
If w already exists in the stack the widget will be removed first.
If w is not a child of this QWidgetStack moves it using reparent().
void QWidgetStack::childEvent | ( | QChildEvent * | ) | [protected, virtual] |
This event handler can be reimplemented in a subclass to receive child events.
Child events are sent to objects when children are inserted or removed.
Note that events with QEvent::type() QEvent::ChildInserted
are posted (with {QApplication::postEvent()}) to make sure that the child's construction is completed before this function is called.
If a child is removed immediately after it is inserted, the ChildInserted
event may be suppressed, but the ChildRemoved
event will always be sent. In such cases it is possible that there will be a ChildRemoved
event without a corresponding ChildInserted
event.
If you change state based on ChildInserted
events, call QWidget::constPolish(), or do
in functions that depend on the state. One notable example is QWidget::sizeHint().
Reimplementado de QObject.
void QWidgetStack::childEvent | ( | QChildEvent * | e | ) | [protected, virtual] |
Reimplementado de QObject.
void QWidgetStack::frameChanged | ( | ) | [protected, virtual] |
Reimplementado de QFrame.
void QWidgetStack::frameChanged | ( | ) | [protected, virtual] |
Returns the ID of the widget. Returns -1 if widget is 0 or is not being managed by this widget stack.
void QWidgetStack::raiseWidget | ( | int | ) | [slot] |
void QWidgetStack::raiseWidget | ( | int | id | ) | [slot] |
Raises the widget with ID id to the top of the widget stack.
void QWidgetStack::raiseWidget | ( | QWidget * | w | ) | [slot] |
Esta es una función miembro sobrecargada que se suministra por conveniencia. Difiere de la anterior función solamente en los argumentos que acepta. Raises widget w to the top of the widget stack.
void QWidgetStack::raiseWidget | ( | QWidget * | ) | [slot] |
void QWidgetStack::removeWidget | ( | QWidget * | w | ) |
Removes widget w from this stack of widgets. Does not delete w. If w is the currently visible widget, no other widget is substituted.
void QWidgetStack::removeWidget | ( | QWidget * | ) |
void QWidgetStack::resizeEvent | ( | QResizeEvent * | e | ) | [protected, virtual] |
Processes the resize event e.
Adjusts the frame rectangle for the resized widget. The frame rectangle is elastic, and the surrounding area is static.
The resulting frame rectangle may be null or invalid. You can use setMinimumSize() to avoid those possibilities.
Nothing is done if the frame rectangle is a null rectangle already.
Reimplementado de QFrame.
Reimplementado en QDesignerWidgetStack.
void QWidgetStack::resizeEvent | ( | QResizeEvent * | e | ) | [protected, virtual] |
Reimplementado de QFrame.
Reimplementado en QDesignerWidgetStack.
void QWidgetStack::setChildGeometries | ( | ) | [protected, virtual] |
Fixes up the children's geometries.
virtual void QWidgetStack::setChildGeometries | ( | ) | [protected, virtual] |
void QWidgetStack::show | ( | ) | [virtual] |
Reimplementado de QWidget.
void QWidgetStack::show | ( | ) | [virtual] |
Shows the widget and its child widgets.
If its size or position has changed, Qt guarantees that a widget gets move and resize events just before it is shown.
You almost never have to reimplement this function. If you need to change some settings before a widget is shown, use showEvent() instead. If you need to do some delayed initialization use polish().
Reimplementado de QWidget.
QWidget * QWidgetStack::visibleWidget | ( | ) | const |
Returns the currently visible widget (the one at the top of the stack), or 0 if nothing is currently being shown.
QWidget* QWidgetStack::visibleWidget | ( | ) | const |
Returns the widget with ID id. Returns 0 if this widget stack does not manage a widget with ID id.