ArcGIS Runtime SDK for iOS
100.15
|
A touch delegate for AGSGeoView
.
A protocol which must be adopted by a class wishing to informed about touch events on AGSMapView
or AGSSceneView
. An instance of the class must then be set as AGSGeoView::touchDelegate
.
All of the methods of this protocol are optional.
@define{AGSGeoView.h, ArcGIS}
Instance Methods | |
(void) | - geoView:didChangeForceTouchAtScreenPoint:mapPoint:force: |
(void) | - geoView:didDoubleTapAtScreenPoint:mapPoint:completion: |
(void) | - geoView:didEndForceTouchAtScreenPoint:mapPoint:force: |
(void) | - geoView:didEndLongPressAtScreenPoint:mapPoint: |
(void) | - geoView:didForceTouchAtScreenPoint:mapPoint:force: |
(void) | - geoView:didLongPressAtScreenPoint:mapPoint: |
(void) | - geoView:didMoveLongPressToScreenPoint:mapPoint: |
(void) | - geoView:didTapAtScreenPoint:mapPoint: |
(void) | - geoView:didTouchDownAtScreenPoint:mapPoint:completion: |
(void) | - geoView:didTouchDragToScreenPoint:mapPoint: |
(void) | - geoView:didTouchUpAtScreenPoint:mapPoint: |
(void) | - geoViewDidCancelForceTouch: |
(void) | - geoViewDidCancelLongPress: |
(void) | - geoViewDidCancelTouchDrag: |
|
optional |
Tells the delegate that the user moved their finger during a force touch interaction.
geoView | on which the user performed the interaction. |
screenPoint | Location in screen coordinates. |
mapPoint | Location in map coordinates. When using an AGSSceneView , the location will have a z-value corresponding to the intersection point on the scene's baseSurface. |
force | Force with which the user touched the point. Force is a normalized value that ranges from 0 which represents the force of an average touch, to 1.0 which is the value of a maximum force touch. |
- screenToLocation:completion: (AGSSceneViewCommon)
to get a location that intersects with any features/graphics on or above the baseSurface.
|
optional |
Tells the delegate that the user double-tapped at the specified location. If the delegate would like to consume this event, it needs to invoke the provided completion block with YES
which will then prevent the geoview from handling the gesture (for eg, it won't zoom the map on double-tap).
geoView | on which the user performed the interaction. |
screenPoint | Location in screen coordinates. |
mapPoint | Location in map coordinates. When using an AGSSceneView , the location will have a z-value corresponding to the intersection point on the scene's baseSurface. |
completion | block that the delegate needs to invoke with a boolean indicating whether or not they want to consume this event. If they consume this event, the geoview will disregard the entire gesture that begins with this event. It will then be the delgate's responsibility to appropriately respond to the gesture. |
- screenToLocation:completion: (AGSSceneViewCommon)
to get a location that intersects with any features/graphics on or above the baseSurface.
|
optional |
Tells the delegate that a force touch interaction ended.
geoView | on which the user performed the interaction. |
screenPoint | Location in screen coordinates. |
mapPoint | Location in map coordinates. When using an AGSSceneView , the location will have a z-value corresponding to the intersection point on the scene's baseSurface. |
force | Force with which the user touched the point. Force is a normalized value that ranges from 0 which represents the force of an average touch, to 1.0 which is the value of a maximum force touch. |
- screenToLocation:completion: (AGSSceneViewCommon)
to get a location that intersects with any features/graphics on or above the baseSurface.
|
optional |
Tells the delegate that the long press interaction has ended.
geoView | on which the user performed the interaction. |
screenPoint | Screen coordinates of where the user ended the tap and hold. |
mapPoint | Map coordinates of where the user ended the tap and hold. When using an AGSSceneView , the location will have a z-value corresponding to the intersection point on the scene's baseSurface. |
- screenToLocation:completion: (AGSSceneViewCommon)
to get a location that intersects with any features/graphics on or above the baseSurface.
|
optional |
Tells the delegate that the user force touched at the specified location. The force touch gesture is recognized when a touch greater than average force is made for more than 300 miliseconds. The average force of a touch is defined by the iOS operating system as a raw force value of 1.0. The force reported by the gesture recognizer is a normalized value that ranges from the average force of a touch to the maximum force of a touch. The force value's range is 0 to 1.0.
geoView | on which the user performed the interaction. |
screenPoint | Location in screen coordinates. |
mapPoint | Location in map coordinates. When using an AGSSceneView , the location will have a z-value corresponding to the intersection point on the scene's baseSurface. |
force | Force with which the user touched the point. Force is a normalized value that ranges from 0 which represents the force of an average touch, to 1.0 which is the value of a maximum force touch. |
- screenToLocation:completion: (AGSSceneViewCommon)
to get a location that intersects with any features/graphics on or above the baseSurface.
|
optional |
Tells the delegate that the user long-pressed at the specified. location.
geoView | on which the user performed the interaction. |
screenPoint | Location in screen coordinates. |
mapPoint | Location in map coordinates. When using an AGSSceneView , the location will have a z-value corresponding to the intersection point on the scene's baseSurface. |
- screenToLocation:completion: (AGSSceneViewCommon)
to get a location that intersects with any features/graphics on or above the baseSurface.
|
optional |
Tells the delegate that the user moved their finger during a long press interaction.
geoView | on which the user performed the interaction. |
screenPoint | Location in screen coordinates. |
mapPoint | Location in map coordinates. When using an AGSSceneView , the location will have a z-value corresponding to the intersection point on the scene's baseSurface. |
- screenToLocation:completion: (AGSSceneViewCommon)
to get a location that intersects with any features/graphics on or above the baseSurface.
|
optional |
Tells the delegate that the user single-tapped at the specified location.
geoView | on which the user performed the interaction. |
screenPoint | Location where the user tapped in screen coordinates. |
mapPoint | Location where the user tapped in map coordinates. When using an AGSSceneView , the location will have a z-value corresponding to the intersection point on the scene's baseSurface. |
- screenToLocation:completion: (AGSSceneViewCommon)
to get a location that intersects with any features/graphics on or above the baseSurface.
|
optional |
Tells the delegate that the user put a finger down at the specified location. This event is the precursor of a tap or a drag gesture. If the delegate would like to consume this event, it needs to invoke the provided completion block with YES
which will then prevent the geoview from handling the gesture (for e.g, it won't pan the map when the finger is dragged). It will then be the delgate's responsibility to appropriately respond to the gesture. This is useful, for instance, if you want to drag graphics on the map for which you would invoke identify
on the graphics overlay and call the completion block with YES
if any graphic was returned.
geoView | on which the user performed the interaction. |
screenPoint | Location where the user put the finger down. |
mapPoint | Location where the user put the finger down. When using an AGSSceneView , the location will have a z-value corresponding to the intersection point on the scene's baseSurface. |
completion | block that the delegate needs to invoke with a boolean indicating whether or not they want to consume this event. If they consume this event, the geoview will disregard the entire gesture that begins with this event. It will then be the delgate's responsibility to appropriately respond to the gesture. |
- screenToLocation:completion: (AGSSceneViewCommon)
to get a location that intersects with any features/graphics on or above the baseSurface.
|
optional |
Tells the delegate that the user dragged their finger to specified location. This event is only raised if the delegate has indicated that they want to consume the immediately prior geoView:didTouchDownAtScreenPoint:mapPoint:completion:
event by passing YES
to the completion block parameter.
geoView | on which the user performed the interaction. |
screenPoint | Location where the user dragged their finger to. |
mapPoint | Location where the user dragged their finger to. When using an AGSSceneView , the location will have a z-value corresponding to the intersection point on the scene's baseSurface. |
- screenToLocation:completion: (AGSSceneViewCommon)
to get a location that intersects with any features/graphics on or above the baseSurface.
|
optional |
Tells the delegate that the user lifted their finger from the screen. This event is only raised if the delegate has indicated that they want to consume the prior geoView:didTouchDownAtScreenPoint:mapPoint:completion:
event.
geoView | on which the user performed the interaction. |
screenPoint | Location where the user lifted their finger. |
mapPoint | Location where the user lifted their finger. When using an AGSSceneView , the location will have a z-value corresponding to the intersection point on the scene's baseSurface. |
- screenToLocation:completion: (AGSSceneViewCommon)
to get a location that intersects with any features/graphics on or above the baseSurface.
|
optional |
Tells the delegate that a force touch interaction was canceled.
geoView | on which the user performed the interaction. |
|
optional |
Tells the delegate that a long press interaction was canceled. This may happen, for instance, when you have the magnifier visible and attempt to take a screenshot using the home/lock button combination.
geoView | on which the user performed the interaction. |
- screenToLocation:completion: (AGSSceneViewCommon)
to get a location that intersects with any features/graphics on or above the baseSurface.
|
optional |
Tells the delegate the drag action was cancelled. This event is only raised if the delegate has indicated that they want to consume the prior geoView:didTouchDownAtScreenPoint:mapPoint:completion:
event.
- screenToLocation:completion: (AGSSceneViewCommon)
to get a location that intersects with any features/graphics on or above the baseSurface.