TabBar QML Type

Ermöglicht es dem Benutzer, zwischen verschiedenen Ansichten oder Teilaufgaben zu wechseln. Mehr...

• Liste aller Mitglieder, einschließlich vererbter Mitglieder

Eigenschaften

• contentHeight : real (since QtQuick.Controls 2.2 (Qt 5.9))
• contentWidth : real (since QtQuick.Controls 2.2 (Qt 5.9))
• position : enumeration

Zugehörige Eigenschaften

• index : int (since QtQuick.Controls 2.3 (Qt 5.10))
• position : enumeration (since QtQuick.Controls 2.3 (Qt 5.10))
• tabBar : TabBar (since QtQuick.Controls 2.3 (Qt 5.10))

Ausführliche Beschreibung

TabBar bietet ein tabbasiertes Navigationsmodell.

TabBar wird mit „ TabButton “-Steuerelementen bestückt und kann zusammen mit jedem Layout oder Container-Steuerelement verwendet werden, das die Eigenschaft „ currentIndex “ bereitstellt, wie beispielsweise „ StackLayout “ oder SwipeView

TabBar {
    id: bar
    width: parent.width
    TabButton {
        text: qsTr("Home")
    }
    TabButton {
        text: qsTr("Discover")
    }
    TabButton {
        text: qsTr("Activity")
    }
}

StackLayout {
    width: parent.width
    currentIndex: bar.currentIndex
    Item {
        id: homeTab
    }
    Item {
        id: discoverTab
    }
    Item {
        id: activityTab
    }
}

Wie oben gezeigt, wird die TabBar in der Regel mit einem statischen Satz von Registerkarten-Schaltflächen bestückt, die inline als untergeordnete Elemente der Registerkartenleiste definiert sind. Es ist auch möglich, Elemente wie „ add “, „ insert “, „ move “ und „ remove “ zur Laufzeit dynamisch hinzuzufügen. Der Zugriff auf die Elemente erfolgt über „ itemAt()“ oder „ contentChildren “.

Wenn „TabBar“ mit einem anderen Container wie „ SwipeView “ gekoppelt ist, muss eine bidirektionale Bindung zwischen den „ currentIndex “-Eigenschaften der einzelnen Steuerelemente hergestellt werden. Um dies zu erreichen, ohne Bindungen zu unterbrechen, sollten Sie es vermeiden, „ currentIndex “ direkt zu setzen, und stattdessen beispielsweise „ setCurrentIndex()“ verwenden. Weitere Informationen finden Sie unter „ Managing the Current Index “.

Um eine Aktion auszuführen, wenn sich „ currentIndex “ ändert, verwenden Sie den Signal-Handler für die Änderung der Eigenschaft „ onCurrentIndexChanged “:

onCurrentIndexChanged: {
    print("currentIndex changed to", currentIndex)
    // ...
}

Anpassen der Größe von Registerkarten

Standardmäßig passt „TabBar“ die Größe ihrer Schaltflächen an die Breite des Steuerelements an. Der verfügbare Platz wird gleichmäßig auf alle Schaltflächen verteilt. Das Standardverhalten bei der Größenanpassung kann überschrieben werden, indem eine explizite Breite für die Schaltflächen festgelegt wird.

Das folgende Beispiel veranschaulicht, wie jede Registerkarte ihre implizite Größe beibehält, anstatt an die Größe der Registerkartenleiste angepasst zu werden:

TabBar {
    width: parent.width
    TabButton {
        text: "First"
        width: implicitWidth
    }
    TabButton {
        text: "Second"
        width: implicitWidth
    }
    TabButton {
        text: "Third"
        width: implicitWidth
    }
}

Wischbare Registerkarten

Wenn die Gesamtbreite der Schaltflächen die verfügbare Breite der Registerkartenleiste überschreitet, wird diese automatisch wischbar.

TabBar {
    id: bar
    width: parent.width

    Repeater {
        model: ["First", "Second", "Third", "Fourth", "Fifth"]

        TabButton {
            text: modelData
            width: Math.max(100, bar.width / 5)
        }
    }
}

Siehe auch „ TabButton“ , „Anpassen der TabBar“, „Navigationssteuerelemente“, „Container-Steuerelemente“ und „Fokusverwaltung“ unter Qt Quick Controls.

Dokumentation zu den Eigenschaften

contentHeight : real [since QtQuick.Controls 2.2 (Qt 5.9)]

Diese Eigenschaft gibt die Höhe des Inhalts an. Sie wird zur Berechnung der impliziten Gesamthöhe der Registerleiste verwendet.

Diese Eigenschaft wurde in QtQuick.Controls 2.2 (Qt 5.9) eingeführt.

Siehe auch „ Container::contentHeight “.

contentWidth : real [since QtQuick.Controls 2.2 (Qt 5.9)]

Diese Eigenschaft enthält die Breite des Inhalts. Sie wird zur Berechnung der impliziten Gesamtbreite der Registerkartenleiste verwendet.

Diese Eigenschaft wurde in QtQuick.Controls 2.2 (Qt 5.9) eingeführt.

Siehe auch Container::contentWidth.

position : enumeration

Diese Eigenschaft legt die Position der Registerkartenleiste fest.

Mögliche Werte:

Der Standardwert ist stilabhängig.

Siehe auch „ ApplicationWindow::header“ , „ ApplicationWindow::footer “, „ Page::header “ und „ Page::footer “.

Dokumentation zu angehängten Eigenschaften

TabBar.index : int [read-only attached, since QtQuick.Controls 2.3 (Qt 5.10)]

Diese angehängte Eigenschaft enthält den Index der einzelnen Registerkarten im „ TabBar “.

Sie ist jeder Registerkarte des „ TabBar “ zugeordnet.

Diese Eigenschaft wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.

TabBar.position : enumeration [read-only attached, since QtQuick.Controls 2.3 (Qt 5.10)]

Diese Eigenschaft legt die Position der Registerkartenleiste fest.

Sie ist an jede Registerkarte des „ TabBar “ angehängt.

Mögliche Werte:

Diese Eigenschaft wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.

TabBar.tabBar : TabBar [read-only attached, since QtQuick.Controls 2.3 (Qt 5.10)]

Diese angehängte Eigenschaft enthält die Registerkartenleiste, die diese Registerkarte verwaltet.

Sie ist an jede Registerkarte des „ TabBar “ angehängt.

Diese Eigenschaft wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.