TabViewStyle QML Type

Provides custom styling for TabView. More...

Import Statement: import QtQuick.Controls.Styles 1.4
Since: Qt 5.1


Detailed Description

TabView {
    id: frame
    anchors.fill: parent
    anchors.margins: 4
    Tab { title: "Tab 1" }
    Tab { title: "Tab 2" }
    Tab { title: "Tab 3" }

    style: TabViewStyle {
        frameOverlap: 1
        tab: Rectangle {
            color: styleData.selected ? "steelblue" :"lightsteelblue"
            border.color:  "steelblue"
            implicitWidth: Math.max(text.width + 4, 80)
            implicitHeight: 20
            radius: 2
            Text {
                id: text
                anchors.centerIn: parent
                text: styleData.title
                color: styleData.selected ? "white" : "black"
        frame: Rectangle { color: "steelblue" }

Property Documentation

[read-only] control : TabView

The ScrollView this style is attached to.

frame : Component

This defines the tab frame.

frameOverlap : int

This property holds the amount of overlap there are between individual tab buttons and the frame.

leftCorner : Component

This defines the left corner.

rightCorner : Component

This defines the right corner.

tab : Component

This defines the tab. You can access the tab state through the styleData property, with the following properties:

readonly property int styleData.indexThis is the current tab index.
readonly property bool styleData.selectedThis is the active tab.
readonly property string styleData.titleTab title text.
readonly property bool styleData.nextSelectedThe next tab is selected.
readonly property bool styleData.previousSelectedThe previous tab is selected.
readonly property bool styleData.pressedThe tab is being pressed. (since QtQuick.Controls.Styles 1.3)
readonly property bool styleData.hoveredThe tab is being hovered.
readonly property bool styleData.enabledThe tab is enabled. (since QtQuick.Controls.Styles 1.2)
readonly property bool styleData.activeFocusThe tab button has keyboard focus.
readonly property bool styleData.availableWidthThe available width for the tabs.
readonly property bool styleData.totalWidthThe total width of the tabs. (since QtQuick.Controls.Styles 1.2)

tabBar : Component

This defines the tab bar background.

tabOverlap : int

This property holds the amount of overlap there are between individual tab buttons.

tabsAlignment : int

This property holds the horizontal alignment of the tab buttons. Supported values are:

  • Qt.AlignLeft (default)
  • Qt.AlignHCenter
  • Qt.AlignRight

tabsMovable : bool

This property holds whether the user can move the tabs. Tabs are not movable by default.

© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.