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

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

contentHeight : real

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

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

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

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

contentWidth : real

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

Примечание: Это свойство доступно в TabBar начиная с QtQuick.Controls 2.2 (Qt 5.9), но оно было продвинуто к типу базового контейнера в 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.

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

[только для чтения] TabBar.index : int

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

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

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

[только для чтения] TabBar.position : перечисление

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

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

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

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

[только для чтения] TabBar.tabBar : TabBar

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

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

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