MSFMapEventListener

Objective-C


@interface MSFMapEventListener : NSObject {
  void *swigCPtr;
  BOOL swigCMemOwn;
}

Swift

class MSFMapEventListener : NSObject

Listener for events like map clicks etc.

  • Listener method that gets called at the end of the rendering process when the map view needs no further refreshing. Note that there can still be background processes (tile loading) that may change the map view but these may take long time. This method is called from GL renderer thread, not from main thread.

    Declaration

    Objective-C

    - (void)onMapIdle;

    Swift

    func onMapIdle()

  • Listener method that gets called at the end of the rendering process when the map view needs no further refreshing. Note that there can still be background processes (tile loading) that may change the map view but these may take long time. This method is called from GL renderer thread, not from main thread.

    Declaration

    Objective-C

    - (void)onMapIdleSwigExplicitMSFMapEventListener;

    Swift

    func onMapIdleSwigExplicitMSFMapEventListener()

  • Listener method that gets called when the map is panned, rotated, tilted or zoomed. The callback is used for both UI events and map changes resulting from API calls; the reason says which. Doing any calls to update MapView state from this method is potentially dangerous and may result in deadlocks or crashes. The thread this method is called from may vary.

    Declaration

    Objective-C

    - (void)onMapMoved:(enum MSFMapMoveReason)reason;

    Swift

    func onMapMoved(_ reason: MSFMapMoveReason)

    Parameters

    reason

    What caused the camera change.

  • Listener method that gets called when the map is panned, rotated, tilted or zoomed. The callback is used for both UI events and map changes resulting from API calls; the reason says which. Doing any calls to update MapView state from this method is potentially dangerous and may result in deadlocks or crashes. The thread this method is called from may vary.

    Declaration

    Objective-C

    - (void)onMapMovedSwigExplicitMSFMapEventListener:(enum MSFMapMoveReason)reason;

    Swift

    func onMapMovedSwigExplicitMSFMapEventListener(_ reason: MSFMapMoveReason)

    Parameters

    reason

    What caused the camera change.

  • Listener method that gets called when the map comes to rest - animations have finished, the user has lifted their fingers from the screen and any inertia has died out.

    This is the end of a movement, not a poll: it is called once per movement, and a touch that did not move the camera does not call it at all. It concerns the CAMERA only - tiles may still be loading, so it is not “everything is drawn”; that is onMapIdle.

    The thread this method is called from may vary.

    Declaration

    Objective-C

    - (void)onMapStable:(enum MSFMapMoveReason)reason;

    Swift

    func onMapStable(_ reason: MSFMapMoveReason)

    Parameters

    reason

    What caused the movement that just ended.

  • Listener method that gets called when the map comes to rest - animations have finished, the user has lifted their fingers from the screen and any inertia has died out.

    This is the end of a movement, not a poll: it is called once per movement, and a touch that did not move the camera does not call it at all. It concerns the CAMERA only - tiles may still be loading, so it is not “everything is drawn”; that is onMapIdle.

    The thread this method is called from may vary.

    Declaration

    Objective-C

    - (void)onMapStableSwigExplicitMSFMapEventListener:
    (enum MSFMapMoveReason)reason;

    Swift

    func onMapStableSwigExplicitMSFMapEventListener(_ reason: MSFMapMoveReason)

    Parameters

    reason

    What caused the movement that just ended.

  • Listener method that gets called when user has interacted with the map. The callback includes info about interaction type (panning, zooming, etc).

    Declaration

    Objective-C

    - (void)onMapInteraction:(MSFMapInteractionInfo *)mapInteractionInfo;

    Swift

    func onMapInteraction(_ mapInteractionInfo: MSFMapInteractionInfo!)

    Parameters

    mapInteractionInfo

    A container that provides information about the interaction.

  • Listener method that gets called when user has interacted with the map. The callback includes info about interaction type (panning, zooming, etc).

    Declaration

    Objective-C

    - (void)onMapInteractionSwigExplicitMSFMapEventListener:
    (MSFMapInteractionInfo *)mapInteractionInfo;

    Swift

    func onMapInteractionSwigExplicitMSFMapEventListener(_ mapInteractionInfo: MSFMapInteractionInfo!)

    Parameters

    mapInteractionInfo

    A container that provides information about the interaction.

  • Listener method that gets called when a click is performed on an empty area of the map. This method will NOT be called from the main thread.

    Declaration

    Objective-C

    - (void)onMapClicked:(MSFMapClickInfo *)mapClickInfo;

    Swift

    func onMapClicked(_ mapClickInfo: MSFMapClickInfo!)

    Parameters

    mapClickInfo

    A container that provides information about the click.

  • Listener method that gets called when a click is performed on an empty area of the map. This method will NOT be called from the main thread.

    Declaration

    Objective-C

    - (void)onMapClickedSwigExplicitMSFMapEventListener:
    (MSFMapClickInfo *)mapClickInfo;

    Swift

    func onMapClickedSwigExplicitMSFMapEventListener(_ mapClickInfo: MSFMapClickInfo!)

    Parameters

    mapClickInfo

    A container that provides information about the click.

  • Undocumented

    Declaration

    Objective-C

    -(id)init;

    Swift

    init!()

  • Undocumented

    Declaration

    Objective-C

    -(void)dealloc;

    Swift

    func dealloc()