<AGSMapViewDelegate> Protocol Reference


Description

A protocol which must be adopted by a class wishing to serve as a delegate for AGSMapView. AGSMapView notifies the delegate of events and consults the delegate before taking some action. Developers can listen to these events and customize the map's behavior by attaching their delegate to the AGSMapView.

All of the methods of this protocol are optional.

Defined in:
AGSMapView.h ( ArcGIS library)
Since:
1.0
Deprecated:
Deprecated at 1.8. use AGSMapViewLayerDelegate, AGSMapViewTouchDelgate and AGSMapViewCalloutDelgate protocols instead.

List of all members.

Public Member Functions

(void) - mapView:didClickAtPoint:mapPoint:graphics:
(void) - mapView:didClickCalloutAccessoryButtonAtPoint:
(void) - mapView:didClickCalloutAccessoryButtonForGPS:
(void) - mapView:didClickCalloutAccessoryButtonForGraphic:
(void) - mapView:didEndTapAndHoldAtPoint:mapPoint:graphics:
(void) - mapView:didLoadLayerForLayerView:
(void) - mapView:didMoveTapAndHoldAtPoint:mapPoint:graphics:
(void) - mapView:didShowCalloutForGPS:
(void) - mapView:didShowCalloutForGraphic:
(void) - mapView:didTapAndHoldAtPoint:mapPoint:graphics:
(void) - mapView:failedLoadingLayerForLayerView:withError:
(void) - mapView:failedLoadingWithError:
(BOOL) - mapView:shouldFindGraphicsInLayer:atPoint:mapPoint:
(BOOL) - mapView:shouldShowCalloutForGPS:
(BOOL) - mapView:shouldShowCalloutForGraphic:
(void) - mapViewDidLoad:

Member Function Documentation

- (void) mapView: (AGSMapView *)  mapView
didClickAtPoint: (CGPoint)  screen
mapPoint: (AGSPoint *)  mappoint 
[optional]

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

Parameters:
mapView Map tapped by the user.
screen Location in screen coordinates.
mappoint Location in map coordinates.
graphics Graphics from all graphics layers in the map that intersect or contain the location. The dictionary contains layer name (key) : AGSGraphic array (value)
Since:
1.0
Deprecated:
Deprecated at 1.8. Use AGSMapViewTouchDelegate protocol instead.
- (void) mapView: (AGSMapView *)  mapView   [optional]

Tells the delegate the callout accessory button was tapped on.

Parameters:
mapView Map containing callout.
point Map point at which callout was shown.
Since:
1.0
Deprecated:
Deprecated at 1.8. Use AGSMapViewCalloutDelegate protocol instead.
- (void) mapView: (AGSMapView *)  mapView   [optional]

Tells the delegate the callout accessory button was tapped on for the GPS callout.

Parameters:
mapView Map containing callout.
gps GPS display for which the callout was shown.
Since:
1.0
Deprecated:
Deprecated at 1.8. Use AGSMapViewCalloutDelegate protocol instead.
- (void) mapView: (AGSMapView *)  mapView   [optional]

Tells the delegate the callout accessory button was tapped on.

Parameters:
mapView Map containing callout.
graphic Graphic for which callout was shown.
Since:
1.0
Deprecated:
Deprecated at 1.8. Use AGSMapViewCalloutDelegate protocol instead.
- (void) mapView: (AGSMapView *)  mapView
didEndTapAndHoldAtPoint: (CGPoint)  screen
mapPoint: (AGSPoint *)  mappoint 
[optional]

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

Parameters:
mapView Map tapped and held by the user.
screen Screen coordinates of where the user ended the tap and hold.
mappoint Map coordinates of where the user ended the tap and hold.
graphics Graphics from all graphics layers in the map that intersect or contain the location. The dictionary contains layer name (key) : AGSGraphic array (value)
Since:
1.0
Deprecated:
Deprecated at 1.8. Use AGSMapViewTouchDelegate protocol instead.
- (void) mapView: (AGSMapView *)  mapView   [optional]

Tells the delegate a layer that was added to the map was loaded.

Parameters:
mapView Map to which layer has been added.
layerView Layer view that was added to map
Since:
1.0
Deprecated:
Deprecated at 1.8. Use AGSMapViewLayerDelegate protocol instead.
- (void) mapView: (AGSMapView *)  mapView
didMoveTapAndHoldAtPoint: (CGPoint)  screen
mapPoint: (AGSPoint *)  mappoint 
[optional]

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

Parameters:
mapView Map tapped and held by the user.
screen Location in screen coordinates.
mappoint Location in map coordinates.
graphics Graphics from all graphics layers in the map that intersect or contain the location. The dictionary contains layer name (key) : AGSGraphic array (value)
Since:
1.0
Deprecated:
Deprecated at 1.8. Use AGSMapViewTouchDelegate protocol instead.
- (void) mapView: (AGSMapView *)  mapView   [optional]

Tells the delegate a callout was shown for the GPS display.

Parameters:
mapView Map containing the callout to be shown.
gps GPS display that the callout was shown for.
Since:
1.0
Deprecated:
Deprecated at 1.8. Use AGSMapViewCalloutDelegate protocol instead.
- (void) mapView: (AGSMapView *)  mapView   [optional]

Tells the delegate callout was shown for a graphic that was tapped on.

Parameters:
mapView Map containing callout.
graphic Graphic for which callout was shown.
Since:
1.0
Deprecated:
Deprecated at 1.8. Use AGSMapViewCalloutDelegate protocol instead.
- (void) mapView: (AGSMapView *)  mapView
didTapAndHoldAtPoint: (CGPoint)  screen
mapPoint: (AGSPoint *)  mappoint 
[optional]

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

Parameters:
mapView Map tapped and held by the user.
screen Location in screen coordinates.
mappoint Location in map coordinates.
graphics Graphics from all graphics layers in the map that intersect or contain the location. The dictionary contains layer name (key) : AGSGraphic array (value)
Since:
1.0
Deprecated:
Deprecated at 1.8. Use AGSMapViewTouchDelegate protocol instead.
- (void) mapView: (AGSMapView *)  mapView
failedLoadingLayerForLayerView: (UIView< AGSLayerView > *)  layerView 
[optional]

Tells the delegate a layer that was added to the map could not be loaded.

Parameters:
mapView Map to which layer had to be added.
layerView Layer view that failed to be added.
error Error describing reason for failure.
Since:
1.0
Deprecated:
Deprecated at 1.8. Use AGSMapViewLayerDelegate protocol instead.
- (void) mapView: (AGSMapView *)  mapView   [optional]

Tells the delegate the map failed to load. This could happen, for instance, if the basemap layer failed to load. When the basemap layer fails to load, other layers in the map are still loaded, but the map does not display any layers.

Parameters:
mapView The map that failed to load.
error Error describing reason for failure.
Since:
1.0
Deprecated:
Deprecated at 1.8. Use AGSMapViewLayerDelegate protocol instead.
- (BOOL) mapView: (AGSMapView *)  mapView
shouldFindGraphicsInLayer: (AGSGraphicsLayer *)  graphicsLayer
atPoint: (CGPoint)  screen 
[optional]

Asks delegate whether to find which graphics in the specified layer intersect the tapped location. Default is YES.

Parameters:
mapView Map containing callout to be shown.
graphicsLayer Graphics layer in which to find graphics.
screen Location in screen coordinates.
mappoint Map point.
Since:
1.0
Deprecated:
Deprecated at 1.8. Use AGSMapViewLayerDelegate protocol instead.
- (BOOL) mapView: (AGSMapView *)  mapView   [optional]

Asks the delegate whether to show a callout when the user taps the GPS display. Default is YES.

Parameters:
mapView Map containing the callout to be shown.
gps GPS display that the callout will be shown for.
Since:
1.0
Deprecated:
Deprecated at 1.8. Use AGSMapViewCalloutDelegate protocol instead.
- (BOOL) mapView: (AGSMapView *)  mapView   [optional]

Asks delegate whether to show callout for a graphic that has been tapped on. Default is YES.

Parameters:
mapView Map containing callout to be shown.
graphic Graphic to show callout for.
Returns:
BOOL value whether callout should be shown for the graphic.
Since:
1.0
Deprecated:
Deprecated at 1.8. Use AGSMapViewCalloutDelegate protocol instead.
- (void) mapViewDidLoad:   [optional]

Tells the delegate the map is loaded and ready for use.

Parameters:
mapView The map that has loaded.
Since:
1.0
Deprecated:
Deprecated at 1.8. Use AGSMapViewLayerDelegate protocol instead.