10.2.5: <AGSMapViewTouchDelegate> Protocol Reference
10.2.5
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Properties Macros Pages
<AGSMapViewTouchDelegate> Protocol Reference

Description

A protocol which must be adopted by a class wishing to be called for touch event related actions happening on the map. An instance of the class must then be set as AGSMapView::touchDelegate .

All of the methods of this protocol are optional.

Defined in:
AGSMapView.h ( ArcGIS library)

Since
1.8
Inheritance diagram for <AGSMapViewTouchDelegate>:
AGSSketchGraphicsLayer

Instance Methods

(void) - mapView:didClickAtPoint:mapPoint:features:
 
(void) - mapView:didClickAtPoint:mapPoint:graphics:
 
(void) - mapView:didEndTapAndHoldAtPoint:mapPoint:features:
 
(void) - mapView:didEndTapAndHoldAtPoint:mapPoint:graphics:
 
(void) - mapView:didMoveTapAndHoldAtPoint:mapPoint:features:
 
(void) - mapView:didMoveTapAndHoldAtPoint:mapPoint:graphics:
 
(void) - mapView:didTapAndHoldAtPoint:mapPoint:features:
 
(void) - mapView:didTapAndHoldAtPoint:mapPoint:graphics:
 
(BOOL) - mapView:shouldProcessClickAtPoint:mapPoint:
 
(BOOL) - mapView:shouldProcessEndTapAndHoldAtPoint:mapPoint:
 
(void) - mapViewDidCancelTapAndHold:
 

Method Documentation

- (void) mapView: (AGSMapView *)  mapView
didClickAtPoint: (CGPoint)  screen
mapPoint: (AGSPoint *)  mappoint
features: (NSDictionary *)  features 
optional

Tells the delegate the map was single-tapped at specified location.

Parameters
mapViewMap tapped by the user.
screenLocation in screen coordinates.
mappointLocation in map coordinates.
featuresid<AGSFeature> objects from all hit-testable layers in the map that intersect or contain the location. The dictionary contains layer name (key) : Array of id<AGSFeature> (value)
Since
10.2

Reimplemented in AGSSketchGraphicsLayer.

- (void) mapView: (AGSMapView *)  mapView
didClickAtPoint: (CGPoint)  screen
mapPoint: (AGSPoint *)  mappoint
graphics: (NSDictionary *)  graphics 
optional

Tells the delegate the map was single-tapped at specified location.

Parameters
mapViewMap tapped by the user.
screenLocation in screen coordinates.
mappointLocation in map coordinates.
graphicsGraphics from all graphics layers in the map that intersect or contain the location. The dictionary contains layer name (key) : AGSGraphic array (value)
Deprecated:
Deprecated at 10.2. Use mapView:didClickAtPoint:mapPoint:features: instead.
Since
1.8
- (void) mapView: (AGSMapView *)  mapView
didEndTapAndHoldAtPoint: (CGPoint)  screen
mapPoint: (AGSPoint *)  mappoint
features: (NSDictionary *)  features 
optional

Tells the delegate that a tap and hold event has ended.

Parameters
mapViewMap tapped and held by the user.
screenScreen coordinates of where the user ended the tap and hold.
mappointMap coordinates of where the user ended the tap and hold.
featuresid<AGSFeature> objects from all hit-testable layers in the map that intersect or contain the location. The dictionary contains layer name (key) : Array of id<AGSFeature> (value)
Since
10.2

Reimplemented in AGSSketchGraphicsLayer.

- (void) mapView: (AGSMapView *)  mapView
didEndTapAndHoldAtPoint: (CGPoint)  screen
mapPoint: (AGSPoint *)  mappoint
graphics: (NSDictionary *)  graphics 
optional

Tells the delegate that a tap and hold event has ended.

Parameters
mapViewMap tapped and held by the user.
screenScreen coordinates of where the user ended the tap and hold.
mappointMap coordinates of where the user ended the tap and hold.
graphicsGraphics from all graphics layers in the map that intersect or contain the location. The dictionary contains layer name (key) : AGSGraphic array (value)
Deprecated:
Deprecated at 10.2. Use mapView:didEndTapAndHoldAtPoint:mapPoint:features: instead.
Since
1.8
- (void) mapView: (AGSMapView *)  mapView
didMoveTapAndHoldAtPoint: (CGPoint)  screen
mapPoint: (AGSPoint *)  mappoint
features: (NSDictionary *)  features 
optional

Tells the delegate that the user moved his finger while tapping and holding on the map.

Parameters
mapViewMap tapped and held by the user.
screenLocation in screen coordinates.
mappointLocation in map coordinates.
featuresid<AGSFeature> objects from all hit-testable layers in the map that intersect or contain the location. The dictionary contains layer name (key) : Array of id<AGSFeature> (value)
Since
10.2
- (void) mapView: (AGSMapView *)  mapView
didMoveTapAndHoldAtPoint: (CGPoint)  screen
mapPoint: (AGSPoint *)  mappoint
graphics: (NSDictionary *)  graphics 
optional

Tells the delegate that the user moved his finger while tapping and holding on the map.

Parameters
mapViewMap tapped and held by the user.
screenLocation in screen coordinates.
mappointLocation in map coordinates.
graphicsGraphics from all graphics layers in the map that intersect or contain the location. The dictionary contains layer name (key) : AGSGraphic array (value)
Deprecated:
Deprecated at 10.2. Use mapView:didMoveTapAndHoldAtPoint:mapPoint:features: instead.
Since
1.8
- (void) mapView: (AGSMapView *)  mapView
didTapAndHoldAtPoint: (CGPoint)  screen
mapPoint: (AGSPoint *)  mappoint
features: (NSDictionary *)  features 
optional

Tells the delegate that a point on the map was tapped and held at specified location.

Parameters
mapViewMap tapped and held by the user.
screenLocation in screen coordinates.
mappointLocation in map coordinates.
featuresid<AGSFeature> objects from all hit-testable layers in the map that intersect or contain the location. The dictionary contains layer name (key) : Array of id<AGSFeature> (value)
Since
10.2
- (void) mapView: (AGSMapView *)  mapView
didTapAndHoldAtPoint: (CGPoint)  screen
mapPoint: (AGSPoint *)  mappoint
graphics: (NSDictionary *)  graphics 
optional

Tells the delegate that a point on the map was tapped and held at specified location.

Parameters
mapViewMap tapped and held by the user.
screenLocation in screen coordinates.
mappointLocation in map coordinates.
graphicsGraphics from all graphics layers in the map that intersect or contain the location. The dictionary contains layer name (key) : AGSGraphic array (value)
Deprecated:
Deprecated at 10.2. Use mapView:didTapAndHoldAtPoint:mapPoint:features: instead.
Since
1.8
- (BOOL) mapView: (AGSMapView *)  mapView
shouldProcessClickAtPoint: (CGPoint)  screen
mapPoint: (AGSPoint *)  mappoint 
optional

Asks the delegate if the map should process the click at the given location. The default value if this method is not implemented is YES.

Parameters
mapViewMap tapped by the user.
screenLocation in screen coordinates.
mappointLocation in map coordinates.
Returns
BOOL value whether the click should be processed by the map.
Since
2.0
- (BOOL) mapView: (AGSMapView *)  mapView
shouldProcessEndTapAndHoldAtPoint: (CGPoint)  screen
mapPoint: (AGSPoint *)  mappoint 
optional

Asks the delegate if the map should process the tap and hold ended event at the given location. The default value if this method is not implemented is YES.

Parameters
mapViewMap tapped by the user.
screenLocation in screen coordinates.
mappointLocation in map coordinates.
Returns
BOOL value whether the end tap and hold should be processed by the map.
Since
2.0
- (void) mapViewDidCancelTapAndHold: (AGSMapView *)  mapView
optional

Tells the delegate that a tap and hold event was cancelled. This may happen when you have the magnifier visible and attempt to take a screenshot using the home/lock button combination.

Parameters
mapViewMap tapped and held by the user.
Since
10.1.1