Spec-Zone.ru › Qt 5.9

Тип QML GaugeStyle

Предоставляет настраиваемую стилизацию для Gauge. Подробнее...

Заявление об импорте: import QtQuick.Controls.Styles 1.4
С: Qt 5.5
  • Список всех членов, включая унаследованные

Свойства

  • background : Компонент
  • control : Gauge
  • foreground : Компонент
  • minorTickmark : Компонент
  • tickmark : Компонент
  • tickmarkLabel : Компонент
  • valueBar : Компонент
  • valuePosition : вещественное

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

Вы можете создать пользовательский измерительный прибор, заменив следующие делегаты:

  • background
  • valueBar
  • tickmarkLabel

Ниже приведен пример того, как создать измерительный прибор температуры, меняющий цвет по мере увеличения его значения:

import QtQuick 2.2
import QtQuick.Controls 1.4
import QtQuick.Controls.Styles 1.4
import QtQuick.Extras 1.4

Rectangle {
    width: 80
    height: 200

    Timer {
        running: true
        repeat: true
        interval: 2000
        onTriggered: gauge.value = gauge.value == gauge.maximumValue ? 5 : gauge.maximumValue
    }

    Gauge {
        id: gauge
        anchors.fill: parent
        anchors.margins: 10

        value: 5
        Behavior on value {
            NumberAnimation {
                duration: 1000
            }
        }

        style: GaugeStyle {
            valueBar: Rectangle {
                implicitWidth: 16
                color: Qt.rgba(gauge.value / gauge.maximumValue, 0, 1 - gauge.value / gauge.maximumValue, 1)
            }
        }
    }
}

Измерительный прибор, отображающий значения в различные моменты анимации.

См. также Стиль измерительного прибора.

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

background : Компонент

Фон измерительного прибора, отображаемый за valueBar.

По умолчанию фон не определен.

[только для чтения] control : Gauge

Gauge, к которому прикреплен этот стиль.

foreground : Компонент

Планка, представляющая переднюю часть измерительного прибора.

Этот компонент отображается над всеми другими компонентами.

minorTickmark : Компонент

Каждая малая риска, отображаемая измерительным прибором.

Для установки размера малых рисок укажите implicitWidth и implicitHeight.

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

В примере ниже уменьшается ширина малых рисок:

minorTickmark: Item {
    implicitWidth: 8
    implicitHeight: 1

    Rectangle {
        color: "#cccccc"
        anchors.fill: parent
        anchors.leftMargin: 2
        anchors.rightMargin: 4
    }
}

Gauge minorTickmark example

Каждый экземпляр этого компонента имеет доступ к следующему свойству:

readonly property int styleData.index Индекс этой малой риски.
readonly property real styleData.value Значение, которое представляет эта малая риска.
readonly property real styleData.valuePosition Значение, которое представляет эта малая риска, как позиция в пикселях, где 0 — в нижней части измерительного прибора.

См. также tickmark.

tickmark : Компонент

Каждая риска, отображаемая измерительным прибором.

Для установки размера рисок укажите implicitWidth и implicitHeight.

Наибольшая ширина риски определит отводимое пространство для всех рисок. По этой причине implicitWidth каждой риски должна быть больше или равна ширине каждой малой риски. Если вам нужны малые риски с большей шириной, чем основные, установите большую ширину в дочернем элементе компонента minorTickmark.

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

В примере ниже уменьшается высота рисок:

tickmark: Item {
    implicitWidth: 18
    implicitHeight: 1

    Rectangle {
        color: "#c8c8c8"
        anchors.fill: parent
        anchors.leftMargin: 3
        anchors.rightMargin: 3
    }
}

Gauge tickmark example

Каждый экземпляр этого компонента имеет доступ к следующим свойствам:

readonly property int styleData.index Индекс этой риски.
readonly property real styleData.value Значение, которое представляет эта риска.
readonly property real styleData.valuePosition Значение, которое представляет эта риска, как позиция в пикселях, где 0 — в нижней части измерительного прибора.

См. также minorTickmark.

tickmarkLabel : Компонент

Это определяет текст каждой метки риски на измерительном приборе.

Каждый экземпляр этого компонента имеет доступ к следующим свойствам:

readonly property int styleData.index Индекс этой метки.
readonly property real styleData.value Значение, которое представляет эта метка.

valueBar : Компонент

Планка, представляющая значение измерительного прибора.

Высота планки value автоматически изменяется в соответствии с value и не требует указания.

При определении пользовательского valueBar его свойство implicitWidth должно быть установлено.

[только для чтения] valuePosition : вещественное

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

Это полезно для пользовательской стилизации.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qml-qtquick-controls-styles-gaugestyle.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API