Тип QML TabBar

Позволяет пользователю переключаться между различными представлениями или подзадачами. Подробнее...

• Список всех членов, включая унаследованные члены

Свойства

• contentHeight : real
• contentWidth : real
• position : перечисление

Присоединённые свойства

• index : int
• position : перечисление
• tabBar : TabBar

Подробное описание

TabBar предоставляет модель навигации на основе вкладок.

TabBar заполняется элементами управления TabButton и может использоваться вместе с любым элементом управления макетом или контейнером, который предоставляет свойство currentIndex, например, StackLayout или 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
    }
}

Как показано выше, TabBar обычно заполняется набором статических кнопок вкладок, которые определяются непосредственно как дочерние элементы панели вкладок. Также возможно динамическое добавление, вставка, перемещение и удаление элементов во время выполнения. К элементам можно получить доступ, используя itemAt() или contentChildren.

Изменение размеров вкладок

По умолчанию TabBar изменяет размер своих кнопок для соответствия ширине элемента управления. Доступное пространство распределяется равномерно между каждой кнопкой. Поведение изменения размера по умолчанию можно переопределить, установив явную ширину для кнопок.

Следующий пример иллюстрирует, как сохранить неявный размер каждой кнопки вкладки вместо изменения её размера для соответствия панели вкладок:

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

Прокручиваемые вкладки

Если общая ширина кнопок превышает доступную ширину панели вкладок, она автоматически становится прокручиваемой.

TabBar {
    id: bar
    width: parent.width

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

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

См. также TabButton, Настройка TabBar, Элементы управления навигацией, Элементы управления контейнерами и Управление фокусом в Qt Quick Controls.

Документация по свойствам

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

Это свойство содержит высоту содержимого. Оно используется для расчета общей неявной высоты панели вкладок.

Это свойство было добавлено в QtQuick.Controls 2.2 (Qt 5.9).

См. также Container::contentHeight.

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

Это свойство содержит ширину содержимого. Оно используется для расчета общей неявной ширины панели вкладок.

Это свойство было добавлено в QtQuick.Controls 2.2 (Qt 5.9).

См. также Container::contentWidth.

position : перечисление

Это свойство содержит положение панели вкладок.

Возможные значения:

Значение по умолчанию зависит от стиля.

См. также ApplicationWindow::header, ApplicationWindow::footer, Page::header и Page::footer.

Документация по присоединённым свойствам

[только для чтения, начиная с QtQuick.Controls 2.3 (Qt 5.10)] TabBar.index : int

Это присоединённое свойство содержит индекс каждой кнопки вкладки в TabBar.

Оно прикреплено к каждой кнопке вкладки в TabBar.

Это свойство было добавлено в QtQuick.Controls 2.3 (Qt 5.10).

[только для чтения, начиная с QtQuick.Controls 2.3 (Qt 5.10)] TabBar.position : перечисление

Это присоединённое свойство содержит положение панели вкладок.

Оно прикреплено к каждой кнопке вкладки в TabBar.

Возможные значения:

Это свойство было добавлено в QtQuick.Controls 2.3 (Qt 5.10).

[только для чтения, начиная с QtQuick.Controls 2.3 (Qt 5.10)] TabBar.tabBar : TabBar

Это присоединённое свойство содержит панель вкладок, которая управляет этой кнопкой вкладки.

Оно прикреплено к каждой кнопке вкладки в TabBar.

Это свойство было добавлено в QtQuick.Controls 2.3 (Qt 5.10).