FGX.Map.TfgMap: различия между версиями

Материал из FGX Native Докуметации
Перейти к навигации Перейти к поиску
(summary)
(summary)
Строка 15: Строка 15:
  
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 +
|-
 +
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>ControlsSettings: [[FGX.Map.Types.TfgMapControlSettings|TfgMapControlSettings]]</code>
 +
<p>Настройки отображения элементов управления картой.</p><small style="color: red"><small>Описание взято от [[FGX.Map.TfgCustomMap.ControlsSettings|ControlsSettings]].</small></small>
 
|-
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>MapType: [[FGX.Map.TfgMapType|TfgMapType]]</code>
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>MapType: [[FGX.Map.TfgMapType|TfgMapType]]</code>
Строка 79: Строка 82:
 
<p>Вызывается, когда карта проинициализирована и готова к использованию. Именно в этот момент можно работать с объектами на карте.</p><small style="color: red"><small>Описание взято от [[FGX.Map.TfgCustomMap.OnMapReady|OnMapReady]].</small></small>
 
<p>Вызывается, когда карта проинициализирована и готова к использованию. Именно в этот момент можно работать с объектами на карте.</p><small style="color: red"><small>Описание взято от [[FGX.Map.TfgCustomMap.OnMapReady|OnMapReady]].</small></small>
 
|-
 
|-
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnTapMarker: [[TfgOnMapMarkerTap]]</code>
+
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnMarkerTap: [[TfgMapMarkerEvent]]</code>
<p>Вызывается, когда пользователь нажимает на маркер.</p><small style="color: red"><small>Описание взято от [[FGX.Map.TfgCustomMap.OnTapMarker|OnTapMarker]].</small></small>
+
<p>Вызывается, когда пользователь нажимает на маркер.</p><small style="color: red"><small>Описание взято от [[FGX.Map.TfgCustomMap.OnMarkerTap|OnMarkerTap]].</small></small>
 +
|-
 +
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnMarkerDragStart: [[TfgMapMarkerEvent]]</code>
 +
<p>Вызывается, когда маркер начинает перетаскиваться.</p><small style="color: red"><small>Описание взято от [[FGX.Map.TfgCustomMap.OnMarkerDragStart|OnMarkerDragStart]].</small></small>
 +
|-
 +
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnMarkerDrag: [[TfgMapMarkerEvent]]</code>
 +
<p>Вызывается повторно во время перетаскивания маркера.</p><small style="color: red"><small>Описание взято от [[FGX.Map.TfgCustomMap.OnMarkerDrag|OnMarkerDrag]].</small></small>
 +
|-
 +
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnMarkerDragEnd: [[TfgMapMarkerEvent]]</code>
 +
<p>Вызывается после перетаскивания маркера.</p><small style="color: red"><small>Описание взято от [[FGX.Map.TfgCustomMap.OnMarkerDragEnd|OnMarkerDragEnd]].</small></small>
 +
|-
 +
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnPolygonTap: [[TfgMapPolygonEvent]]</code>
 +
<p>Вызывается, когда пользователь нажимает на полигон.</p><small style="color: red"><small>Описание взято от [[FGX.Map.TfgCustomMap.OnPolygonTap|OnPolygonTap]].</small></small>
 +
|-
 +
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnPolylineTap: [[TfgMapPolylineEvent]]</code>
 +
<p>Вызывается, когда пользователь нажимает на кривую.</p><small style="color: red"><small>Описание взято от [[FGX.Map.TfgCustomMap.OnPolylineTap|OnPolylineTap]].</small></small>
 +
|-
 +
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnCircleTap: [[TfgMapCircleEvent]]</code>
 +
<p>Вызывается, когда пользователь нажимает на круг.</p><small style="color: red"><small>Описание взято от [[FGX.Map.TfgCustomMap.OnCircleTap|OnCircleTap]].</small></small>
 
|-
 
|-
 
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnDestroy: [[TNotifyEvent]]</code>
 
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnDestroy: [[TNotifyEvent]]</code>

Версия 01:28, 16 мая 2020

Delphi

TfgMap = class (TfgCustomMap)

TComponent -> TfgControl -> TfgCustomMap -> TfgMap

Описание

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

Для того, чтобы начать использовать камеру на Android, необходимо получить API ключ от Google Maps. Это делается таким же способом, как и для FMX. Инструкция доступна здесь: http://docwiki.embarcadero.com/RADStudio/Rio/en/Configuring_Android_Applications_to_Use_Google_Maps

Google карта требует наличие следующих разрешений, которые нужно запросить при помощи сервиса TfgPermissionService в рантайме:

  • android.permission.ACCESS_COARSE_LOCATION
  • android.permission.ACCESS_FINE_LOCATION

Обратите внимание, что работа с маркерами доступна только после полной загрузки карты, а именно в событии OnMapReady или позже.

На каждой платформе используется свой провайдер карты. На Андроиде - Google Map.

Описание взято от TfgCustomMap.

Свойства

property
ControlsSettings: TfgMapControlSettings

Настройки отображения элементов управления картой.

Описание взято от ControlsSettings.
property
MapType: TfgMapType

Тип карты.

Описание взято от MapType.
property
GoogleMapStyle: TfgGoogleMapStyleOptions

Настройки стиля Google карты.

Актуально только для Андроид платформы.
Описание взято от GoogleMapStyle.
property
Alignment: TfgControlAlignment

Настройки выравнивания контрола в рамках родителя.

Описание взято от Alignment.
property
AlignWithMargins: Boolean

Нужно ли использовать заданные внешние отступы Margins .

Описание взято от AlignWithMargins.
property
Enabled: Boolean

Настройка отключения реакции на воздействия пользователя на компонент.

Описание взято от Enabled.
property
Locked: Boolean

Позволяет заблокировать выделение компонента мышкой в дизайн тайме.

Описание взято от Locked.
property
LookupName: string

Идентификатор, используемый для поиска данного контрола среди других. Актуально для ситуаций, когда несколько контролов могут иметь одно и тоже имя для поиска и нам нужно найти данный контрол в определенной части поддерева.

Описание взято от LookupName.
property
PositionMode: TfgPositionMode

Режим позиционирования контрола в рамках родителя (в абсолютных координатах / относительно).

Описание взято от PositionMode.
property
Position: TfgPosition

Позиция контрола в локальных логических координатах родителя Parent .

Описание взято от Position.
property
RelativePosition: TfgRelativePosition

Относительная позиция контролов относительно родителя. Актуально только для PositionMode = Relative .

Описание взято от RelativePosition.
property
Size: TfgSize

Размер контрола в логических координатах.

Описание взято от Size.
property
Constraints: TfgConstraints

Ограничение на размеры контрола.

Описание взято от Constraints.
property
Margins: TfgMargins

Внешние отступы контрола. Используются при выравнивании текущего контрола в рамках контейнера.

Описание взято от Margins.
property
GestureKinds: TfgGestureKinds

Виды поддерживаемых жестов.

Описание взято от GestureKinds.
property
HitTest: Boolean

Описание отсутствует.

property
Opacity: Single

Прозрачность контрола.

Описание взято от Opacity.
property
Visible: Boolean

Видимость контрола.

Описание взято от Visible.

События

event
OnCameraChanging: TNotifyEvent

Срабатывает в процессе изменения параметров камеры.

Описание взято от OnCameraChanging.
event
OnMapReady: TNotifyEvent

Вызывается, когда карта проинициализирована и готова к использованию. Именно в этот момент можно работать с объектами на карте.

Описание взято от OnMapReady.
event
OnMarkerTap: TfgMapMarkerEvent

Вызывается, когда пользователь нажимает на маркер.

Описание взято от OnMarkerTap.
event
OnMarkerDragStart: TfgMapMarkerEvent

Вызывается, когда маркер начинает перетаскиваться.

Описание взято от OnMarkerDragStart.
event
OnMarkerDrag: TfgMapMarkerEvent

Вызывается повторно во время перетаскивания маркера.

Описание взято от OnMarkerDrag.
event
OnMarkerDragEnd: TfgMapMarkerEvent

Вызывается после перетаскивания маркера.

Описание взято от OnMarkerDragEnd.
event
OnPolygonTap: TfgMapPolygonEvent

Вызывается, когда пользователь нажимает на полигон.

Описание взято от OnPolygonTap.
event
OnPolylineTap: TfgMapPolylineEvent

Вызывается, когда пользователь нажимает на кривую.

Описание взято от OnPolylineTap.
event
OnCircleTap: TfgMapCircleEvent

Вызывается, когда пользователь нажимает на круг.

Описание взято от OnCircleTap.
event
OnDestroy: TNotifyEvent

Вызывается перед удалением контрола. А именно перед вызовом деструктора.

Описание взято от OnDestroy.
event
OnResized: TfgResizedEvent

Вызывается когда контрол изменил свой размерм.

Описание взято от OnResized.
event
OnPositionChanged: TfgPositionChangedEvent

Вызывается когда контрол поменял свою позицию.

Описание взято от OnPositionChanged.
event
OnTouch: TfgTouchEvent

Вызывается в момент касания пользователем экрана устройства.

Описание взято от OnTouch.
event
OnTap: TNotifyEvent

Срабатывает, когда пользователь коротко нажимает на экран без перемещения пальца по экрану.

Описание взято от OnTap.