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

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).