Тип 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

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

Примечание: Это свойство доступно в TabBar с QtQuick.Controls 2.2 (Qt 5.9), но оно было перенесено в базовый тип Container в QtQuick.Controls 2.5 (Qt 5.12).

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

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

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

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

Примечание: Это свойство доступно в TabBar с QtQuick.Controls 2.2 (Qt 5.9), но оно было перенесено в базовый тип Container в QtQuick.Controls 2.5 (Qt 5.12).

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

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

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

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

Примечание: Если панели вкладок назначены как заголовок или подвал ApplicationWindow или Page, соответствующее положение устанавливается автоматически.

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

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

См. также 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).