Sophie

Sophie

distrib > * > 2009.0 > i586 > by-pkgid > a6711891ce757817bba854bf3f25205a > files > 2220

qtjambi-doc-4.3.3-3mdv2008.1.i586.rpm

<class name="QStackedWidget" doc="/**
&lt;p&gt;The &lt;a href=&quot;QStackedWidget.html#QStackedWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;QStackedWidget&lt;/tt&gt;&lt;/a&gt; class provides a stack of widgets where only one widget is visible at a time.&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;QStackedWidget.html#QStackedWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;QStackedWidget&lt;/tt&gt;&lt;/a&gt; can be used to create a user interface similar to the one provided by &lt;a href=&quot;QTabWidget.html&quot;&gt;&lt;tt&gt;QTabWidget&lt;/tt&gt;&lt;/a&gt;. It is a convenience layout widget built on top of the &lt;a href=&quot;QStackedLayout.html&quot;&gt;&lt;tt&gt;QStackedLayout&lt;/tt&gt;&lt;/a&gt; class.&lt;/p&gt;
&lt;p&gt;Like &lt;a href=&quot;QStackedLayout.html&quot;&gt;&lt;tt&gt;QStackedLayout&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QStackedWidget.html#QStackedWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;QStackedWidget&lt;/tt&gt;&lt;/a&gt; can be constructed and populated with a number of child widgets (&amp;quot;pages&amp;quot;):&lt;/p&gt;
&lt;pre&gt;        QWidget *firstPageWidget = new QWidget;
        QWidget *secondPageWidget = new QWidget;
        QWidget *thirdPageWidget = new QWidget;

        QStackedWidget *stackedWidget = new QStackedWidget;
        stackedWidget-&amp;gt;addWidget(firstPageWidget);
        stackedWidget-&amp;gt;addWidget(secondPageWidget);
        stackedWidget-&amp;gt;addWidget(thirdPageWidget);

        QVBoxLayout *layout = new QVBoxLayout;
        layout-&amp;gt;addWidget(stackedWidget);
        setLayout(layout);&lt;/pre&gt;
&lt;p&gt;&lt;a href=&quot;QStackedWidget.html#QStackedWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;QStackedWidget&lt;/tt&gt;&lt;/a&gt; provides no intrinsic means for the user to switch page. This is typically done through a &lt;a href=&quot;QComboBox.html&quot;&gt;&lt;tt&gt;QComboBox&lt;/tt&gt;&lt;/a&gt; or a &lt;a href=&quot;QListWidget.html&quot;&gt;&lt;tt&gt;QListWidget&lt;/tt&gt;&lt;/a&gt; that stores the titles of the &lt;a href=&quot;QStackedWidget.html#QStackedWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;QStackedWidget&lt;/tt&gt;&lt;/a&gt;'s pages. For example:&lt;/p&gt;
&lt;pre&gt;        QComboBox *pageComboBox = new QComboBox;
        pageComboBox-&amp;gt;addItem(tr(&amp;quot;Page 1&amp;quot;));
        pageComboBox-&amp;gt;addItem(tr(&amp;quot;Page 2&amp;quot;));
        pageComboBox-&amp;gt;addItem(tr(&amp;quot;Page 3&amp;quot;));
        connect(pageComboBox, SIGNAL(activated(int)),
                stackedWidget, SLOT(setCurrentIndex(int)));&lt;/pre&gt;
&lt;p&gt;When populating a stacked widget, the widgets are added to an internal list. The &lt;a href=&quot;QStackedWidget.html#indexOf(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;indexOf&lt;/tt&gt;&lt;/a&gt; function returns the index of a widget in that list. The widgets can either be added to the end of the list using the &lt;a href=&quot;QStackedWidget.html#addWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;addWidget&lt;/tt&gt;&lt;/a&gt; function, or inserted at a given index using the &lt;a href=&quot;QStackedWidget.html#insertWidget(int, com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;insertWidget&lt;/tt&gt;&lt;/a&gt; function. The &lt;a href=&quot;QStackedWidget.html#removeWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;removeWidget&lt;/tt&gt;&lt;/a&gt; function removes the widget at the given index from the stacked widget. The number of widgets contained in the stacked widget, can be obtained using the &lt;a href=&quot;QStackedWidget.html#count()&quot;&gt;&lt;tt&gt;count&lt;/tt&gt;&lt;/a&gt; function.&lt;/p&gt;
&lt;p&gt;The &lt;a href=&quot;QStackedWidget.html#widget(int)&quot;&gt;&lt;tt&gt;widget&lt;/tt&gt;&lt;/a&gt; function returns the widget at a given index position. The index of the widget that is shown on screen is given by &lt;a href=&quot;QStackedWidget.html#currentIndex()&quot;&gt;&lt;tt&gt;currentIndex&lt;/tt&gt;&lt;/a&gt; and can be changed using &lt;a href=&quot;QStackedWidget.html#setCurrentIndex(int)&quot;&gt;&lt;tt&gt;setCurrentIndex&lt;/tt&gt;&lt;/a&gt;. In a similar manner, the currently shown widget can be retrieved using the &lt;a href=&quot;QStackedWidget.html#currentWidget()&quot;&gt;&lt;tt&gt;currentWidget&lt;/tt&gt;&lt;/a&gt; function, and altered using the &lt;a href=&quot;QStackedWidget.html#setCurrentWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;setCurrentWidget&lt;/tt&gt;&lt;/a&gt; function.&lt;/p&gt;
&lt;p&gt;Whenever the current widget in the stacked widget changes or a widget is removed from the stacked widget, the &lt;a href=&quot;QStackedWidget.html#currentChanged(int)&quot;&gt;&lt;tt&gt;currentChanged&lt;/tt&gt;&lt;/a&gt; and &lt;a href=&quot;QStackedWidget.html#widgetRemoved(int)&quot;&gt;&lt;tt&gt;widgetRemoved&lt;/tt&gt;&lt;/a&gt; signals are emitted respectively.&lt;/p&gt;

@see &lt;a href=&quot;QStackedLayout.html&quot;&gt;&lt;tt&gt;QStackedLayout&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QTabWidget.html&quot;&gt;&lt;tt&gt;QTabWidget&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;%2E%2E/qtjambi-configdialog.html&quot;&gt;Config Dialog Example&lt;/tt&gt;&lt;/a&gt; */">
    <signal name="protected final void currentChanged(int arg__1)" doc="/**
&lt;p&gt;This signal is emitted whenever the current widget changes.&lt;/p&gt;
&lt;p&gt;The parameter holds the &lt;tt&gt;arg__1&lt;/tt&gt; of the new current widget, or -1 if there isn't a new one (for example, if there are no widgets in the &lt;a href=&quot;QStackedWidget.html#QStackedWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;QStackedWidget&lt;/tt&gt;&lt;/a&gt;).&lt;/p&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;Compatible Slot Signatures:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot(int arg__1)&lt;/tt&gt;&lt;/dd&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot()&lt;/tt&gt;&lt;/dd&gt;
&lt;/dl&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;See Also:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;a href=&quot;QStackedWidget.html#currentWidget()&quot;&gt;&lt;tt&gt;currentWidget&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QStackedWidget.html#setCurrentWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;setCurrentWidget&lt;/tt&gt;&lt;/a&gt;&lt;/dd&gt;
&lt;/dl&gt;
 */"/>
    <signal name="protected final void customContextMenuRequested(com.trolltech.qt.core.QPoint pos)" doc="/**
&lt;p&gt;This signal is emitted when the widget's &lt;a href=&quot;QWidget.html#contextMenuPolicy()&quot;&gt;&lt;tt&gt;contextMenuPolicy&lt;/tt&gt;&lt;/a&gt; is Qt::CustomContextMenu, and the user has requested a context menu on the widget. The position &lt;tt&gt;pos&lt;/tt&gt; is the position of the context menu event that the widget receives. Normally this is in widget coordinates. The exception to this rule is &lt;a href=&quot;QAbstractScrollArea.html&quot;&gt;&lt;tt&gt;QAbstractScrollArea&lt;/tt&gt;&lt;/a&gt; and its subclasses that map the context menu event to coordinates of the viewport()&lt;/tt&gt; .&lt;/p&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;Compatible Slot Signatures:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot(com.trolltech.qt.core.QPoint pos)&lt;/tt&gt;&lt;/dd&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot()&lt;/tt&gt;&lt;/dd&gt;
&lt;/dl&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;See Also:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;a href=&quot;QWidget.html#mapToGlobal(com.trolltech.qt.core.QPoint)&quot;&gt;&lt;tt&gt;mapToGlobal&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QMenu.html&quot;&gt;&lt;tt&gt;QMenu&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QWidget.html#contextMenuPolicy()&quot;&gt;&lt;tt&gt;contextMenuPolicy&lt;/tt&gt;&lt;/a&gt;&lt;/dd&gt;
&lt;/dl&gt;
 */"/>
    <signal name="protected final void widgetRemoved(int index)" doc="/**
&lt;p&gt;This signal is emitted whenever a widget is removed. The widget's &lt;tt&gt;index&lt;/tt&gt; is passed as parameter.&lt;/p&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;Compatible Slot Signatures:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot(int index)&lt;/tt&gt;&lt;/dd&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot()&lt;/tt&gt;&lt;/dd&gt;
&lt;/dl&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;See Also:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;a href=&quot;QStackedWidget.html#removeWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;removeWidget&lt;/tt&gt;&lt;/a&gt;&lt;/dd&gt;
&lt;/dl&gt;
 */"/>
    <method name="public QStackedWidget(com.trolltech.qt.gui.QWidget parent)" doc="/**
&lt;p&gt;Constructs a &lt;a href=&quot;QStackedWidget.html#QStackedWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;QStackedWidget&lt;/tt&gt;&lt;/a&gt; with the given &lt;tt&gt;parent&lt;/tt&gt;.&lt;/p&gt;

@see &lt;a href=&quot;QStackedWidget.html#addWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;addWidget&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QStackedWidget.html#insertWidget(int, com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;insertWidget&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public QStackedWidget()" doc="/**
&lt;p&gt;Equivalent to &lt;a href=&quot;QStackedWidget.html#QStackedWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;QStackedWidget&lt;/tt&gt;&lt;/a&gt;(0). */"/>
    <method name="public final int addWidget(com.trolltech.qt.gui.QWidget w)" doc="/**
&lt;p&gt;Appends the given &lt;tt&gt;w&lt;/tt&gt; to this &lt;a href=&quot;QStackedWidget.html#QStackedWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;QStackedWidget&lt;/tt&gt;&lt;/a&gt; and returns the index position.&lt;/p&gt;
&lt;p&gt;If the &lt;a href=&quot;QStackedWidget.html#QStackedWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;QStackedWidget&lt;/tt&gt;&lt;/a&gt; is empty before this function is called, &lt;tt&gt;w&lt;/tt&gt; becomes the current widget.&lt;/p&gt;

@see &lt;a href=&quot;QStackedWidget.html#insertWidget(int, com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;insertWidget&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QStackedWidget.html#removeWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;removeWidget&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QStackedWidget.html#setCurrentWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;setCurrentWidget&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final int count()" doc="/**
&lt;p&gt;Returns the number of widgets contained by this stacked widget.&lt;/p&gt;

@see &lt;a href=&quot;QStackedWidget.html#currentIndex()&quot;&gt;&lt;tt&gt;currentIndex&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QStackedWidget.html#widget(int)&quot;&gt;&lt;tt&gt;widget&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final int currentIndex()" doc="/**
&lt;p&gt;Returns the index position of the widget that is visible.&lt;/p&gt;
&lt;p&gt;The current index is -1 if there is no current widget.&lt;/p&gt;

@see &lt;a href=&quot;QStackedWidget.html#setCurrentIndex(int)&quot;&gt;&lt;tt&gt;setCurrentIndex&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QStackedWidget.html#currentWidget()&quot;&gt;&lt;tt&gt;currentWidget&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QStackedWidget.html#indexOf(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;indexOf&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final com.trolltech.qt.gui.QWidget currentWidget()" doc="/**
&lt;p&gt;Returns the current widget, or 0 if there are no child widgets.&lt;/p&gt;

@see &lt;a href=&quot;QStackedWidget.html#currentIndex()&quot;&gt;&lt;tt&gt;currentIndex&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QStackedWidget.html#setCurrentWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;setCurrentWidget&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final int indexOf(com.trolltech.qt.gui.QWidget arg__1)" doc="/**
&lt;p&gt;Returns the index of the given &lt;tt&gt;arg__1&lt;/tt&gt;, or -1 if the given &lt;tt&gt;arg__1&lt;/tt&gt; is not a child of this &lt;a href=&quot;QStackedWidget.html#QStackedWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;QStackedWidget&lt;/tt&gt;&lt;/a&gt;.&lt;/p&gt;

@see &lt;a href=&quot;QStackedWidget.html#currentIndex()&quot;&gt;&lt;tt&gt;currentIndex&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QStackedWidget.html#widget(int)&quot;&gt;&lt;tt&gt;widget&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final int insertWidget(int index, com.trolltech.qt.gui.QWidget w)" doc="/**
&lt;p&gt;Inserts the given &lt;tt&gt;w&lt;/tt&gt; at the given &lt;tt&gt;index&lt;/tt&gt; in this &lt;a href=&quot;QStackedWidget.html#QStackedWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;QStackedWidget&lt;/tt&gt;&lt;/a&gt;. If &lt;tt&gt;index&lt;/tt&gt; is out of range, the &lt;tt&gt;w&lt;/tt&gt; is appended (in which case it is the actual index of the &lt;tt&gt;w&lt;/tt&gt; that is returned).&lt;/p&gt;
&lt;p&gt;If the &lt;a href=&quot;QStackedWidget.html#QStackedWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;QStackedWidget&lt;/tt&gt;&lt;/a&gt; was empty before this function is called, the given &lt;tt&gt;w&lt;/tt&gt; becomes the current widget.&lt;/p&gt;
&lt;p&gt;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.&lt;/p&gt;

@see &lt;a href=&quot;QStackedWidget.html#addWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;addWidget&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QStackedWidget.html#removeWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;removeWidget&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QStackedWidget.html#setCurrentWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;setCurrentWidget&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final void removeWidget(com.trolltech.qt.gui.QWidget w)" doc="/**
&lt;p&gt;Removes the given &lt;tt&gt;w&lt;/tt&gt; from this &lt;a href=&quot;QStackedWidget.html#QStackedWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;QStackedWidget&lt;/tt&gt;&lt;/a&gt;. The widget is &lt;i&gt;not&lt;/i&gt; deleted.&lt;/p&gt;

@see &lt;a href=&quot;QStackedWidget.html#addWidget(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;addWidget&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QStackedWidget.html#insertWidget(int, com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;insertWidget&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QStackedWidget.html#currentWidget()&quot;&gt;&lt;tt&gt;currentWidget&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final void setCurrentIndex(int index)" doc="/**
&lt;p&gt;Sets the index position of the widget that is visible to &lt;tt&gt;index&lt;/tt&gt;.&lt;/p&gt;
&lt;p&gt;The current index is -1 if there is no current widget.&lt;/p&gt;

@see &lt;a href=&quot;QStackedWidget.html#currentIndex()&quot;&gt;&lt;tt&gt;currentIndex&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QStackedWidget.html#currentWidget()&quot;&gt;&lt;tt&gt;currentWidget&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QStackedWidget.html#indexOf(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;indexOf&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final void setCurrentWidget(com.trolltech.qt.gui.QWidget w)" doc="/**
&lt;p&gt;Sets the current widget to be the specified &lt;tt&gt;w&lt;/tt&gt;. The new current widget must already be contained in this stacked widget.&lt;/p&gt;

@see &lt;a href=&quot;QStackedWidget.html#currentWidget()&quot;&gt;&lt;tt&gt;currentWidget&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QStackedWidget.html#setCurrentIndex(int)&quot;&gt;&lt;tt&gt;setCurrentIndex&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final com.trolltech.qt.gui.QWidget widget(int arg__1)" doc="/**
&lt;p&gt;Returns the widget at the given &lt;tt&gt;arg__1&lt;/tt&gt;, or 0 if there is no such widget.&lt;/p&gt;

@see &lt;a href=&quot;QStackedWidget.html#currentWidget()&quot;&gt;&lt;tt&gt;currentWidget&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QStackedWidget.html#indexOf(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;indexOf&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public boolean event(com.trolltech.qt.core.QEvent e)" doc="/**
&lt;p&gt;This function is reimplemented for internal reasons.&lt;/p&gt;
 */"/>
</class>