====== Reference Viewer Interactivity ======

This page is about user-driven interactivity between the Viewer and the third-party map. 

===== Zooming to Extent =====

When the user executes the "Zoom to Extent" action on a resource, all Views zoom to the extent of a single Resource.  The reference viewer should do the same.

In order to implement this, you can listen to the ''onZoomToExtent'' Signal.  When the event is dispatched, it will have a payload of type ''Extent''.  You can use this extent to perform the same zoom in the reference viewer.


===== Picking a Position =====

When the user executes the "Move View" or "New View" functions, the user can use any View to select a position to respectively move to or open a new View at.  The user should also be able to use the reference viewer to select a position.  

In order to implement this, 2 Signals are available : 
  * ''onPickPositionRequested'' : Dispatched when a position is needed.  If your user uses the reference viewer to select one, use the ''setPickPosition()'' to pass it along.
  * ''onPickPositionCancelled'' : Dispatched when a position is no longer needed. The user may have used one of the other Views to pick a position.