Класс MfwMapObject
Класс MfwMapObject представляет собой базовый класс для создания некоторых картографических объектов на карте. Подробнее…
| Подключение: | #include <MfwMapObject> |
| Наследники: | MfwGeoJsonMapObject, MfwGroupMapObject, MfwImageMapObject, MfwPinMapObject, MfwShapeMapObject и MfwTextMapObject |
Свойства
- id : const QString
- maxZoomLevel : qint8
- minZoomLevel : qint8
- visible : QString
Публичные функции
| MfwMapObject(QObject *parent = nullptr) | |
| ~MfwMapObject() | |
| QVariantList | getCoordinatesArray(QVariantList coordinates) |
| QJsonObject | getLayerParams() |
| qint8 | getMaxZoomLevel() const |
| qint8 | getMinZoomLevel() const |
| box | getRTreeBox() const |
| QJsonObject | getSourceParams() |
| QString | getVisible() const |
| QString | id() const |
| void | setLayerParams(QJsonObject params) |
| void | setMaxZoomLevel(qint8 maxZoomLevel) |
| void | setMinZoomLevel(qint8 minZoomLevel) |
| void | setRTreeBox() |
| void | setSourceParams(QJsonObject params) |
| void | setVisible(QString visible) |
| void | updateLayerJson(QString section, QString prop, QVariant value) |
| void | updateSourceJson(QString section, QString prop, QVariant value) |
Сигналы
| void | mapObjectLayoutChanged(QString layer, QString prop, QVariant value) |
| void | mapObjectPaintChanged(QString layer, QString prop, QVariant value) |
| void | mapObjectSourceChanged(QString id, QVariantMap sourceParams) |
| void | maxZoomLevelChanged(qint8 maxZoomLevel) |
| void | minZoomLevelChanged(qint8 minZoomLevel) |
| void | rTreeBoxChanged(box oldRTreeBox, box rTreeBox, MfwMapObject *obj) |
| void | visibleChanged(QString visible) |
Подробное описание
Класс MfwMapObject представляет собой базовый класс для создания некоторых картографических объектов на карте.
Этот класс предоставляет основные функциональные возможности для объектов карты, включая управление видимостью и ограничение уровня масштабирования.
Описание свойств
id : const QString
Это свойство содержит уникальный идентификатор объекта карты.
Идентификатор — это строка, которая однозначно идентифицирует объект карты. Он используется для ссылки на объект и управления им в библиотеке отображения MFW.
Функции доступа:
| QString | id() const |
maxZoomLevel : qint8
Это свойство содержит максимальный уровень масштабирования, при котором объект виден.
Максимальный уровень масштабирования — это целочисленное значение, определяющее максимальный уровень масштабирования, при котором объект карты остается видимым. Выше этого уровня объект не отображается на карте.
Функции доступа:
| qint8 | getMaxZoomLevel() const |
| void | setMaxZoomLevel(qint8 maxZoomLevel) |
Сигнал уведомления:
| void | maxZoomLevelChanged(qint8 maxZoomLevel) |
minZoomLevel : qint8
Это свойство содержит минимальный уровень масштабирования, при котором объект виден.
Минимальный уровень масштабирования — это целочисленное значение, определяющее наименьший уровень масштабирования, при котором объект карты остается видимым. Ниже этого уровня объект не отображается на карте.
Функции доступа:
| qint8 | getMinZoomLevel() const |
| void | setMinZoomLevel(qint8 minZoomLevel) |
Сигнал уведомления:
| void | minZoomLevelChanged(qint8 minZoomLevel) |
visible : QString
Это свойство отображает состояние видимости объекта карты.
Свойство visible указывает, виден ли объект карты на карте. Оно представлено в виде QString, с возможными значениями «visible» или «none».
Функции доступа:
| QString | getVisible() const |
| void | setVisible(QString visible) |
Сигнал уведомления:
| void | visibleChanged(QString visible) |
Описание функций-членов
MfwMapObject::MfwMapObject(QObject *parent = nullptr)
Конструктор для MfwMapObject.
Инициализирует новый экземпляр класса MfwMapObject. Этот конструктор позволяет указать родительский QObject.
- parent — родительский QObject, по умолчанию nullptr.
MfwMapObject::~MfwMapObject()
Деструктор для MfwMapObject.
Очищает ресурсы, используемые экземпляром MfwMapObject. Обеспечивает надлежащее удаление приватной реализации.
QVariantList MfwMapObject::getCoordinatesArray(QVariantList coordinates)
Преобразует QVariantList координат в формат, подходящий для JSON.
Обрабатывает список координат и преобразует их в формат, который можно использовать в JSON-конфигурациях.
- coordinates — QVariantList, содержащий координаты для обработки.
QJsonObject MfwMapObject::getLayerParams()
Получает параметры слоя объекта карты изображения.
Возвращает объект QJsonObject, содержащий параметры слоя, с которым связано изображение.
box MfwMapObject::getRTreeBox() const
Возвращает географическую границу объекта карты.
Этот метод возвращает ограничительную рамку объекта карты в виде структуры box, представляющей географическую область,
покрываемую объектом карты.
Возвращает ограничительную рамку объекта карты в формате box.
QJsonObject MfwMapObject::getSourceParams()
Получает исходные параметры для объекта карты изображений.
Возвращает объект QJsonObject, содержащий параметры источника изображения, включая URL и координаты.
[signal] void MfwMapObject::mapObjectLayoutChanged(QString layer, QString prop, QVariant value)
Сигнал, испускаемый при изменении свойства layout объекта карты.
Этот сигнал испускается каждый раз, когда свойство макета, указанное в 'prop' в слое 'layer', обновляется.
- layer — имя слоя.
- prop — имя свойства.
- value — обновленное значение свойства.
[signal] void MfwMapObject::mapObjectPaintChanged(QString layer, QString prop, QVariant value)
Сигнал, испускаемый при изменении свойства paint объекта карты.
Этот сигнал испускается каждый раз, когда свойство закраски, указанное в 'prop' в слое 'layer', обновляется.
- layer — имя слоя.
- prop — имя свойства.
- value — обновленное значение свойства.
[signal] void MfwMapObject::mapObjectSourceChanged(QString id, QVariantMap sourceParams)
Сигнал, испускаемый при изменении исходных параметров объекта карты.
Этот сигнал испускается всякий раз, когда обновляются исходные параметры объекта карты, идентифицированного по 'id'.
- id — идентификатор объекта карты.
- sourceParams — обновленные параметры источника в виде QVariantMap.
[signal] void MfwMapObject::maxZoomLevelChanged(qint8 maxZoomLevel)
Выдается при изменении максимального уровня масштабирования объекта карты.
Этот сигнал указывает на изменение максимального уровня масштабирования, при котором виден объект карты.
- maxZoomLevel — новый максимальный уровень зума в виде qint8.
Примечание. Сигнал уведомления для свойства maxZoomLevel.
[signal] void MfwMapObject::minZoomLevelChanged(qint8 minZoomLevel)
Выдается при изменении минимального уровня масштабирования объекта карты.
Этот сигнал указывает на изменение минимального уровня масштабирования, при котором объект карты виден.
- minZoomLevel — новый минимальный уровень масштабирования в виде qint8.
Примечание. Сигнал уведомления для свойства minZoomLevel.
[signal] void MfwMapObject::rTreeBoxChanged(box oldRTreeBox, box rTreeBox, MfwMapObject *obj)
Сигнал, испускаемый при изменении ограничительной рамки R-дерева объекта карты.
- oldRTreeBox — предыдущая ограничительная рамка.
- rTreeBox — новая ограничительная рамка.
- obj — указатель на MfwMapObject с измененной ограничительной рамкой.
void MfwMapObject::setLayerParams(QJsonObject params)
Устанавливает параметры слоя для объекта карты изображений.
Обновляет параметры слоя с помощью объекта QJsonObject. Сюда могут входить свойства стиля и другие специфические настройки слоя.
- params — объект QJsonObject, содержащий параметры слоя.
void MfwMapObject::setMaxZoomLevel(qint8 maxZoomLevel)
Устанавливает максимальный уровень масштабирования, при котором объект карты будет виден.
- maxZoomLevel — максимальный уровень масштабирования, который необходимо установить для объекта карты.
Примечание. Сеттер для свойства maxZoomLevel.
void MfwMapObject::setMinZoomLevel(qint8 minZoomLevel)
Устанавливает минимальный уровень масштабирования, при котором объект карты будет виден.
- minZoomLevel — минимальный уровень масштабирования, который необходимо установить для объекта карты.
Примечание. Сеттер для свойства minZoomLevel.
void MfwMapObject::setRTreeBox()
Устанавливает ограничительную рамку для объекта карты на основе параметров его источника данных.
Этот метод вычисляет и обновляет ограничительную рамку объекта карты, анализируя параметры «bbox» из GeoJSON-данных объекта, если они доступны. Если параметр «bbox» отсутствует, метод пытается вычислить ограничительную рамку на основе объектов, коллекций объектов или геометрий, определенных в данных. После обновления ограничительной рамки, если она была изменена, испускается сигнал rTreeBoxChanged.
Если имеются данные GeoJSON типа «FeatureCollection» или «GeometryCollection», метод анализирует каждый элемент коллекции для расчета ограничительной рамки.
void MfwMapObject::setSourceParams(QJsonObject params)
Устанавливает параметры источника для объекта карты изображения.
Обновляет параметры источника изображения с помощью объекта QJsonObject, который включает такие свойства, как URL и координаты.
- params — объект QJsonObject, содержащий исходные параметры.
void MfwMapObject::setVisible(QString visible)
Устанавливает статус видимости объекта карты.
Обновляет видимость объекта карты. Возможные значения: «visible» для отображения объекта и «none» для его скрытия.
- visible — QString, указывающая новый статус видимости.
Примечание. Сеттер для свойства visible.
void MfwMapObject::updateLayerJson(QString section, QString prop, QVariant value)
Обновляет определенное свойство в JSON-конфигурации слоя.
Изменяет определенное свойство в JSON-конфигурации слоя, позволяя динамически обновлять настройки слоя.
- section — раздел в JSON, который необходимо обновить.
- prop — имя свойства, которое необходимо обновить.
- value — новое значение для указанного свойства.
void MfwMapObject::updateSourceJson(QString section, QString prop, QVariant value)
Обновляет определенное свойство в исходной конфигурации JSON.
Изменяет определенное свойство в JSON-конфигурации источника, позволяя динамически изменять настройки источника изображений.
- section — раздел в JSON, который необходимо обновить.
- prop — имя свойства, которое необходимо обновить.
- value — новое значение для указанного свойства.
[signal] void MfwMapObject::visibleChanged(QString visible)
Сигнал, испускаемый при изменении видимости объекта карты.
Этот сигнал испускается при изменении свойства 'visible' объекта карты.
- visible — обновленный статус видимости в виде QString.
Примечание. Сигнал уведомления для свойства visible.