Тип QML прямоугольника

Рисует заполненный прямоугольник с необязательной границей. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• antialiasing : bool
• граница
  • border.color : цвет
  • border.width : int
• цвет : цвет
• градиент : любой
• радиус : вещественное

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

Элементы прямоугольника используются для заполнения областей сплошным цветом или градиентами и/или для создания прямоугольной границы.

Внешний вид

Каждый элемент прямоугольника рисуется с использованием либо сплошного цвета заливки, заданного свойством цвет, либо градиента, определенного с помощью типа Градиент и заданного свойством градиент. Если заданы и цвет, и градиент, используется градиент.

Вы можете добавить необязательную границу к прямоугольнику со своим цветом и толщиной, задав свойства border.color и border.width. Установите цвет в «прозрачный», чтобы нарисовать границу без цвета заливки.

Вы также можете создать закругленные прямоугольники, используя свойство радиус. Поскольку это добавляет криволинейные края к углам прямоугольника, может быть целесообразно установить свойство Item::antialiasing для улучшения его внешнего вида.

Пример использования

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

import QtQuick 2.0

Rectangle {
    width: 100
    height: 100
    color: "red"
    border.color: "black"
    border.width: 5
    radius: 10
}

Производительность

Использование свойства Item::antialiasing улучшает внешний вид закругленного прямоугольника за счёт снижения производительности рендеринга. Вы должны отключить это свойство для движущихся прямоугольников и установить его только при их неподвижности.

См. также Изображение.

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

antialiasing : bool

Используется для определения, должен ли прямоугольник использовать сглаживание или нет. Сглаживание предоставляет информацию о последствиях для производительности этого свойства.

По умолчанию значение true для прямоугольников с радиусом и false в противном случае.

border.color : цвет

Ширина и цвет, используемые для рисования границы прямоугольника.

Ширина 1 создаёт тонкую линию. Для отсутствия линии используйте ширину 0 или прозрачный цвет.

Граница рендерится в пределах границ прямоугольника.

цвет : цвет

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

Значение по умолчанию — белый цвет.

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

Rectangle {
    color: "#00B000"
    width: 80; height: 80
}

Rectangle {
    color: "steelblue"
    y: 100; width: 80; height: 80
}

Если заданы и градиент, и цвет, будет использоваться градиент.

См. также gradient.

градиент : любой

Градиент, используемый для заполнения прямоугольника.

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

Rectangle {
    y: 0; width: 80; height: 80
    color: "lightsteelblue"
}

Rectangle {
    y: 100; width: 80; height: 80
    gradient: Gradient {
        GradientStop { position: 0.0; color: "lightsteelblue" }
        GradientStop { position: 1.0; color: "blue" }
    }
}

Rectangle {
    y: 200; width: 80; height: 80
    rotation: 90
    gradient: Gradient {
        GradientStop { position: 0.0; color: "lightsteelblue" }
        GradientStop { position: 1.0; color: "blue" }
    }
}

Свойство также принимает предустановленные градиенты из QGradient::Preset. Однако следует отметить, что поскольку Rectangle поддерживает только простые вертикальные или горизонтальные градиенты, любой предустановленный градиент с недопустимым углом будет преобразован в ближайшее представление.

Rectangle {
    y: 0; width: 80; height: 80
    gradient: Gradient.NightFade
}

Rectangle {
    y: 0; width: 80; height: 80
    gradient: "NightFade"
}

Если заданы и градиент, и цвет, будет использоваться градиент.

См. также Градиент и цвет.

радиус : вещественное

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

Если радиус не равен нулю, прямоугольник будет нарисован как закругленный прямоугольник, в противном случае он будет нарисован как обычный прямоугольник. Один и тот же радиус используется для всех 4 углов; в настоящее время нет способа задать разные радиусы для разных углов.