|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.trolltech.qt.internal.QSignalEmitterInternal
com.trolltech.qt.QSignalEmitter
com.trolltech.qt.QtJambiObject
com.trolltech.qt.core.QObject
com.trolltech.qt.gui.QWidget
com.trolltech.qt.gui.QFrame
com.trolltech.qt.gui.QStackedWidget
public class QStackedWidget
The QStackedWidget class provides a stack of widgets where only one widget is visible at a time. QStackedWidget can be used to create a user interface similar to the one provided by QTabWidget
. It is a convenience layout widget built on top of the QStackedLayout
class.
Like QStackedLayout
, QStackedWidget can be constructed and populated with a number of child widgets ("pages"):
QWidget firstPageWidget = new QWidget(); QWidget secondPageWidget = new QWidget(); QWidget thirdPageWidget = new QWidget(); QStackedWidget stackedWidget = new QStackedWidget(); stackedWidget.addWidget(firstPageWidget); stackedWidget.addWidget(secondPageWidget); stackedWidget.addWidget(thirdPageWidget); QVBoxLayout layout = new QVBoxLayout(); layout.addWidget(stackedWidget); setLayout(layout);QStackedWidget provides no intrinsic means for the user to switch page. This is typically done through a
QComboBox
or a QListWidget
that stores the titles of the QStackedWidget's pages. For example: QComboBox pageComboBox = new QComboBox(); pageComboBox.addItem(tr("Page 1")); pageComboBox.addItem(tr("Page 2")); pageComboBox.addItem(tr("Page 3")); pageComboBox.activated.connect(stackedWidget, "setCurrentIndex(int)");When populating a stacked widget, the widgets are added to an internal list. The
indexOf()
function returns the index of a widget in that list. The widgets can either be added to the end of the list using the addWidget()
function, or inserted at a given index using the insertWidget()
function. The removeWidget()
function removes a widget from the stacked widget. The number of widgets contained in the stacked widget, can be obtained using the count()
function. The widget()
function returns the widget at a given index position. The index of the widget that is shown on screen is given by currentIndex()
and can be changed using setCurrentIndex()
. In a similar manner, the currently shown widget can be retrieved using the currentWidget()
function, and altered using the setCurrentWidget()
function.
Whenever the current widget in the stacked widget changes or a widget is removed from the stacked widget, the currentChanged()
and widgetRemoved()
signals are emitted respectively.
QStackedLayout
, QTabWidget
, and Config Dialog Example.
Nested Class Summary |
---|
Nested classes/interfaces inherited from class com.trolltech.qt.gui.QFrame |
---|
QFrame.Shadow, QFrame.Shape, QFrame.StyleMask |
Nested classes/interfaces inherited from class com.trolltech.qt.gui.QWidget |
---|
QWidget.RenderFlag, QWidget.RenderFlags |
Nested classes/interfaces inherited from class com.trolltech.qt.internal.QSignalEmitterInternal |
---|
com.trolltech.qt.internal.QSignalEmitterInternal.AbstractSignalInternal |
Field Summary | |
---|---|
QSignalEmitter.Signal1 |
currentChanged
This signal takes 1 generic argument(s). |
QSignalEmitter.Signal1 |
widgetRemoved
This signal takes 1 generic argument(s). |
Fields inherited from class com.trolltech.qt.gui.QWidget |
---|
customContextMenuRequested |
Fields inherited from class com.trolltech.qt.internal.QSignalEmitterInternal |
---|
currentSender |
Constructor Summary | |
---|---|
QStackedWidget()
Constructs a QStackedWidget with the given parent. |
|
QStackedWidget(QWidget parent)
Constructs a QStackedWidget with the given parent. |
Method Summary | |
---|---|
int |
addWidget(QWidget w)
Appends the given widget to the QStackedWidget and returns the index position. |
int |
count()
This property holds the number of widgets contained by this stacked widget. |
int |
currentIndex()
This property holds the index position of the widget that is visible. |
QWidget |
currentWidget()
Returns the current widget, or 0 if there are no child widgets. |
int |
indexOf(QWidget arg__1)
Returns the index of the given widget, or -1 if the given widget is not a child of the QStackedWidget. |
int |
insertWidget(int index,
QWidget w)
Inserts the given widget at the given index in the QStackedWidget. |
void |
removeWidget(QWidget w)
Removes the given widget from the QStackedWidget. |
void |
setCurrentIndex(int index)
This property holds the index position of the widget that is visible. |
void |
setCurrentWidget(QWidget w)
Sets the current widget to be the specified widget. |
QWidget |
widget(int arg__1)
Returns the widget at the given index, or 0 if there is no such widget. |
Methods inherited from class com.trolltech.qt.gui.QFrame |
---|
frameRect, frameShadow, frameShape, frameStyle, frameWidth, lineWidth, midLineWidth, setFrameRect, setFrameShadow, setFrameShape, setFrameStyle, setLineWidth, setMidLineWidth |
Methods inherited from class com.trolltech.qt.core.QObject |
---|
childEvent, children, connectSlotsByName, customEvent, disposeLater, dumpObjectInfo, dumpObjectTree, dynamicPropertyNames, event, eventFilter, findChild, findChild, findChild, findChildren, findChildren, findChildren, findChildren, indexOfProperty, installEventFilter, isWidgetType, killTimer, moveToThread, objectName, parent, properties, property, removeEventFilter, setObjectName, setParent, setProperty, startTimer, timerEvent, toString, userProperty |
Methods inherited from class com.trolltech.qt.QtJambiObject |
---|
dispose, disposed, equals, finalize, reassignNativeResources, tr, tr, tr |
Methods inherited from class com.trolltech.qt.QSignalEmitter |
---|
blockSignals, disconnect, disconnect, signalsBlocked, signalSender, thread |
Methods inherited from class com.trolltech.qt.internal.QSignalEmitterInternal |
---|
__qt_signalInitialization |
Methods inherited from class java.lang.Object |
---|
clone, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Methods inherited from interface com.trolltech.qt.QtJambiInterface |
---|
disableGarbageCollection, nativeId, nativePointer, reenableGarbageCollection, setJavaOwnership |
Field Detail |
---|
public final QSignalEmitter.Signal1 currentChanged
This signal takes 1 generic argument(s). We list their type and the name they go by in the description of this signal. <java.lang.Integer(named: index)>:
This signal is emitted whenever the current widget changes.
The parameter holds the index of the new current widget, or -1 if there isn't a new one (for example, if there are no widgets in the QStackedWidget).
currentWidget()
, and setCurrentWidget()
.
public final QSignalEmitter.Signal1 widgetRemoved
This signal takes 1 generic argument(s). We list their type and the name they go by in the description of this signal. <java.lang.Integer(named: index)>:
This signal is emitted whenever a widget is removed. The widget's index is passed as parameter.
removeWidget()
.
Constructor Detail |
---|
public QStackedWidget()
addWidget()
, and insertWidget()
.
public QStackedWidget(QWidget parent)
addWidget()
, and insertWidget()
.
Method Detail |
---|
public final int addWidget(QWidget w)
If the QStackedWidget is empty before this function is called, widget becomes the current widget.
insertWidget()
, removeWidget()
, and setCurrentWidget()
.
public final int count()
currentIndex()
, and widget()
.
public final int currentIndex()
By default, this property contains a value of -1 because the stack is initially empty.
currentWidget()
, and indexOf()
.
public final QWidget currentWidget()
currentIndex()
, and setCurrentWidget()
.
public final int indexOf(QWidget arg__1)
currentIndex()
, and widget()
.
public final int insertWidget(int index, QWidget w)
If the QStackedWidget was empty before this function is called, the given widget becomes the current widget.
Inserting a new widget at an index less than or equal to the current index will increment the current index, but keep the current widget.
addWidget()
, removeWidget()
, and setCurrentWidget()
.
public final void removeWidget(QWidget w)
addWidget()
, insertWidget()
, and currentWidget()
.
public final void setCurrentIndex(int index)
By default, this property contains a value of -1 because the stack is initially empty.
currentWidget()
, and indexOf()
.
public final void setCurrentWidget(QWidget w)
currentWidget()
, and setCurrentIndex()
.
public final QWidget widget(int arg__1)
currentWidget()
, and indexOf()
.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |