<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

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
graphics:		(NSDictionary *)	graphics
				[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

- (void) mapView:		(AGSMapView *)	mapView
didClickCalloutAccessoryButtonAtPoint:		(AGSPoint *)	point
				[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

- (void) mapView:		(AGSMapView *)	mapView
didClickCalloutAccessoryButtonForGPS:		(AGSGPS *)	gps
				[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

- (void) mapView:		(AGSMapView *)	mapView
didClickCalloutAccessoryButtonForGraphic:		(AGSGraphic *)	graphic
				[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

- (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:

	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

- (void) mapView:		(AGSMapView *)	mapView
didLoadLayerForLayerView:		(UIView< AGSLayerView > *)	layerView
				[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

- (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:

	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

- (void) mapView:		(AGSMapView *)	mapView
didShowCalloutForGPS:		(AGSGPS *)	gps
				[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

- (void) mapView:		(AGSMapView *)	mapView
didShowCalloutForGraphic:		(AGSGraphic *)	graphic
				[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

- (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:

	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

- (void) mapView:		(AGSMapView *)	mapView
failedLoadingLayerForLayerView:		(UIView< AGSLayerView > *)	layerView
withError:		(NSError *)	error
				[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

- (void) mapView:		(AGSMapView *)	mapView
failedLoadingWithError:		(NSError *)	error
				[optional]

Tells the delegate the map failed to load.

Parameters:

	mapView	The map that failed to load.
	error	Error describing reason for failure.

Since:

1.0

- (BOOL) mapView:		(AGSMapView *)	mapView
shouldFindGraphicsInLayer:		(AGSGraphicsLayer *)	graphicsLayer
atPoint:		(CGPoint)	screen
mapPoint:		(AGSPoint *)	mappoint
				[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

- (BOOL) mapView:		(AGSMapView *)	mapView
shouldShowCalloutForGPS:		(AGSGPS *)	gps
				[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

- (BOOL) mapView:		(AGSMapView *)	mapView
shouldShowCalloutForGraphic:		(AGSGraphic *)	graphic
				[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

- (void) mapViewDidLoad:

(AGSMapView *)

mapView

[optional]

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

Parameters:

mapView

The map that has loaded.

Since:

1.0