Тип QML MapRectangle

Тип MapRectangle отображает прямоугольник на карте. Подробнее...

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

Свойства

• autoFadeIn : bool
• backend : MapRectangle.Backend
• border
  • border.color : цвет
  • border.width : int
• bottomRight : координаты
• color : цвет
• opacity : вещественное число
• topLeft : координаты

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

Тип MapRectangle отображает прямоугольник на карте. Прямоугольники — это частный случай многоугольников с ровно 4 вершинами и 4 «прямыми» сторонами. В этом случае «прямые» означает, что верхняя левая точка имеет такую же широту, как и верхняя правая точка (верхняя сторона), а нижняя левая точка имеет такую же широту, как и нижняя правая точка (нижняя сторона). Аналогично, точки слева имеют такую же долготу, а точки справа — такую же долготу.

Для задания прямоугольника требуется точка topLeft и точка bottomRight, обе задаваемые с помощью координат coordinate.

По умолчанию прямоугольник отображается с прозрачной заливкой и черной границей толщиной в 1 пиксель. Это можно изменить, используя свойства color, border.color и border.width.

Примечание: Подобно типу MapPolygon, MapRectangle — это географические объекты, поэтому перетаскивание MapRectangle приводит к перерасчёту его вершин в географическом пространстве координат. Видимое растяжение элемента происходит при перетаскивании на другую широту, однако его стороны остаются прямыми.

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

MapRectangle имеет затраты на отрисовку, идентичные затратам MapPolygon с 4 вершинами.

Как и другие объекты карты, MapRectangle обычно отображается без плавного внешнего вида. Установка свойства opacity заставит объект смешиваться, что значительно снижает производительность в зависимости от используемого оборудования.

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

Следующий фрагмент кода демонстрирует карту, содержащую MapRectangle, охватывающую область от (-27, 153) до (-28, 153.5), недалеко от Брисбена, Австралия. Прямоугольник заполнен зелёным цветом с чёрной границей толщиной в 2 пикселя.

Map {
    MapRectangle {
        color: 'green'
        border.width: 2
        topLeft {
            latitude: -27
            longitude: 153
        }
        bottomRight {
            latitude: -28
            longitude: 153.5
        }
    }
}

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

autoFadeIn : bool

Это свойство указывает, будет ли элемент автоматически выводиться при приближении к карте, начиная с очень низких уровней масштабирования. По умолчанию это true. Установка этого свойства в false заставляет элемент карты всегда иметь непрозрачность, указанную свойством QtQuick::Item::opacity, которая по умолчанию равна 1.0.

Это свойство было введено в Qt 5.14.

backend : MapRectangle.Backend

Это свойство указывает, какой бэкенд используется для отрисовки элемента карты. Допустимые значения — MapRectangle.Software и MapRectangle.OpenGL. Значение по умолчанию — MapRectangle.Software.

Примечание: Выпуск этого API с Qt 5.15 является предварительным технологическим просмотром. В идеале, по мере созревания OpenGL-бэкендов для элементов карты, больше не будет необходимости предлагать также бэкенд старой проекции на основе программного обеспечения. Поэтому это свойство, вероятно, исчезнет в какой-то момент в будущем. Чтобы выбрать OpenGL-ускоренные бэкенды элементов без использования этого свойства, можно также установить переменную среды QTLOCATION_OPENGL_ITEMS в 1. Также обратите внимание, что все текущие OpenGL-бэкенды не будут работать должным образом при включении слоёв на отдельных элементах или при запуске на профилях OpenGL, больших чем 2.x.

Это свойство было введено в Qt 5.15.

border.color : цвет

Это свойство является частью группы свойств border. Группа свойств border содержит ширину и цвет, используемые для рисования границы прямоугольника. Ширина задаётся в пикселях и не зависит от уровня масштабирования карты.

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

bottomRight : координаты

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

color : цвет

Это свойство хранит цвет заливки прямоугольника. Для отсутствия заливки используйте прозрачный цвет.

opacity : вещественное число

Это свойство хранит непрозрачность элемента. Непрозрачность задаётся числом от 0 (полностью прозрачный) до 1 (полностью непрозрачный). Значение по умолчанию — 1.

Элемент с непрозрачностью 0 всё ещё будет получать события мыши. Чтобы отключить события мыши, установите свойство видимости элемента в false.

topLeft : координаты

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