The Bing Maps control provides many events to allow your application to respond to user actions. The Map, Pushpin, Polyline, Polygon and Layer classes along with many of the modules all have events. Here are a couple of examples of where you may want to use events:
- If a user clicks on a shape, trigger an event that opens an infobox.
- If the map style changes you may want to change the color of items overlaid on the map so that they stand out better -- for example, using light colors on aerial maps and dark colors on road maps.
- If the user has moved the map you may wish to load in new data for the new viewing area.
- Map Events
- Pushpin Events
- Polyline Events
- Polygon Events
- Data Layer Events
- Right Click Events for Shapes
The following example shows how to add a viewchange event to the map and have the location information of the center of the map displayed and updated as the map moves.
As you pan the map you will notice that the location information for the center of the map will appear below the map.
Tip: Some of the events, such as the mouse related events, pass an event argument to the event handler. This event argument can contain important information such as a reference to the target object the event is attached to, or the pixel coordinates where the mouse event occurred. If you want to get the coordinates of a mouse event, use the
location property of the event argument.