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

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

contentHeight : real

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

Если явно не переопределено, высота содержимого автоматически вычисляется на основе максимальной неявной высоты вкладок.

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

См. также contentWidth.

contentWidth : real

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

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

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

См. также contentHeight.

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