Тип QML MapRectangle

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

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

Свойства

• border
  • border.width : int
  • border.color : цвет
• bottomRight : координата
• цвет : цвет
• прозрачность : вещественное
• topLeft : координата

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

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

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

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

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

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

MapRectangles имеют стоимость отрисовки, идентичную MapPolygon с 4 вершинами.

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

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

Следующий фрагмент кода показывает карту, содержащую 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
        }
    }
}

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

border.width : int

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

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

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

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

цвет : цвет

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

прозрачность : вещественное

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

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

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

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