Qt Documentation

Contents

TabView QML Type

A control that allows the user to select one of multiple stacked items. More...

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

FocusScope

Properties

Methods

  • Tab addTab(string title, Component component)
  • Tab getTab(int index)
  • Tab insertTab(int index, string title, Component component)
  • void moveTab(int from, int to)
  • void removeTab(int index)

Detailed Description

TabView provides tab-based navigation model for your application. For example, the following snippet uses tabs to present rectangles of different color on each tab page:

TabView {
    Tab {
        title: "Red"
        Rectangle { color: "red" }
    }
    Tab {
        title: "Blue"
        Rectangle { color: "blue" }
    }
    Tab {
        title: "Green"
        Rectangle { color: "green" }
    }
}

Note: You can create a custom appearance for a TabView by assigning a TabViewStyle.

Tab represents the content of a tab in a TabView.

Property Documentation

[read-only] contentItem : Item

This property holds the content item of the tab view.

Tabs declared as children of a TabView are automatically parented to the TabView's contentItem.

This QML property was introduced in QtQuick.Controls 1.3.


[read-only] count : int

The current tab count


currentIndex : int

The current tab index


frameVisible : bool

The visibility of the tab frame around contents


tabPosition : int

  • Qt.TopEdge (default)
  • Qt.BottomEdge

tabsVisible : bool

The visibility of the tab bar


Method Documentation

Tab addTab(string title, Component component)

Adds a new tab with the given title and an optional component.

Returns the newly added tab.


Tab getTab(int index)

Returns the Tab item at index.


Tab insertTab(int index, string title, Component component)

Inserts a new tab at index, with the given title and an optional component.

Returns the newly added tab.


void moveTab(int from, int to)

Moves a tab from index to another.


void removeTab(int index)

Removes and destroys a tab at the given index.


© 2017 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.