MapMarker
Базовая оболочка маркера для MapCanvas с поддержкой произвольного контента, текстовых меток, состояний выбора и подсветки.
Обзор
MapMarker — нейтральная базовая оболочка для отображения маркеров на холсте MapCanvas.
Ключевые возможности:
- Размещение произвольных дочерних UI-виджетов или текстовых меток (content, label).
- Встроенные визуальные состояния выбора (selected) и целевой подсветки (highlighted).
- Прозрачный базовый стиль без лишних фонов и рамок для аккуратного отображения иконок и надписей.
- Управляется низкоуровневым объектом AnchorWidget для точного позиционирования.
Создание и настройка маркера карты
Связанные ссылки
- 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: Текущий экземпляр для цепочки вызовов..