Перейти к содержанию

MapMarker

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

Обзор

MapMarker — нейтральная базовая оболочка для отображения маркеров на холсте MapCanvas.

Ключевые возможности: - Размещение произвольных дочерних UI-виджетов или текстовых меток (content, label). - Встроенные визуальные состояния выбора (selected) и целевой подсветки (highlighted). - Прозрачный базовый стиль без лишних фонов и рамок для аккуратного отображения иконок и надписей. - Управляется низкоуровневым объектом AnchorWidget для точного позиционирования.

Создание и настройка маркера карты

MapMarker marker = new MapMarker("Waypoint");
marker.selected(true);

Связанные ссылки

  • AnchorWidget: Пространственный якорь, привязывающий экранный UI-виджет к мировым координатам с масштабированием от зума, настройкой pivot и отсечением вне экрана.
  • MapCanvas: Интерактивный виджет 2D-карты, расширяющий WorldCanvas поддержкой размеров карты, слоями текстур и сетки, проекцией координат и маркерами.
  • MapMarkerHandle: Дескриптор для удобной настройки положения, экранного размера, масштабирования от зума, опорной точки (pivot) и видимости маркера на MapCanvas.

API

MapMarker()

Создает пустую оболочку маркера без стандартного оформления поверхности.

MapMarker(String)

Создает оболочку маркера с простой текстовой меткой.

Параметр Тип Описание
text String Простая текстовая строка.

MapMarker::anchor()

Возвращает низкоуровневый AnchorWidget, управляющий позиционированием этого маркера.

Возвращает AnchorWidget: Управляющий AnchorWidget..

MapMarker::content()

Возвращает текущий виджет контента, вложенный в этот маркер.

Возвращает Widget: Виджет контента..

MapMarker::content(Widget)

Заменяет виджет контента, вложенный в этот маркер.

Параметр Тип Описание
content Widget Вложенный виджет контента.

Возвращает MapMarker: Текущий экземпляр для цепочки вызовов..

MapMarker::highlighted()

Возвращает true, если маркер в данный момент подсвечен.

Возвращает boolean: True, если активно, включено или успешно..

MapMarker::highlighted(boolean)

Устанавливает визуальное состояние подсветки маркера.

Параметр Тип Описание
highlighted boolean Флаг состояния подсветки.

Возвращает MapMarker: Текущий экземпляр для цепочки вызовов..

MapMarker::label()

Возвращает виджет Label, если контентом является текстовая метка, или null в противном случае.

Возвращает Label: Экземпляр виджета Label или null..

MapMarker::label(String)

Заменяет контент маркера на текстовый виджет Label.

Параметр Тип Описание
text String Простая текстовая строка.

Возвращает MapMarker: Текущий экземпляр для цепочки вызовов..

MapMarker::selected()

Возвращает true, если маркер в данный момент находится в выбранном состоянии.

Возвращает boolean: True, если активно, включено или успешно..

MapMarker::selected(boolean)

Устанавливает визуальное состояние выбора маркера.

Параметр Тип Описание
selected boolean Флаг состояния выбора.

Возвращает MapMarker: Текущий экземпляр для цепочки вызовов..