Utility functions for event handling.
OpenLayers. Event | Utility functions for event handling. |
Constants | |
KEY_BACKSPACE | {int} |
KEY_TAB | {int} |
KEY_RETURN | {int} |
KEY_ESC | {int} |
KEY_LEFT | {int} |
KEY_UP | {int} |
KEY_RIGHT | {int} |
KEY_DOWN | {int} |
KEY_DELETE | {int} |
OpenLayers. Events | |
Constants | |
BROWSER_EVENTS | {Array(String)} supported events |
Properties | |
fallThrough | {Boolean} |
includeXY | {Boolean} Should the .xy property automatically be created for browser mouse events? |
Constructor | |
OpenLayers. Events | Construct an OpenLayers.Events object. |
Functions | |
destroy | |
addEventType | Add a new event type to this events object. |
register | Register an event on the events object. |
registerPriority | Same as register() but adds the new listener to the front of the events queue instead of to the end. |
unregister | |
triggerEvent | Trigger a specified registered event. |
clearMouseCache | Clear cached data about the mouse position. |
Constants | |
BROWSER_EVENTS | {Array(String)} supported events |
Properties | |
fallThrough | {Boolean} |
includeXY | {Boolean} Should the .xy property automatically be created for browser mouse events? |
Constructor | |
OpenLayers. Events | Construct an OpenLayers.Events object. |
Functions | |
destroy | |
addEventType | Add a new event type to this events object. |
register | Register an event on the events object. |
registerPriority | Same as register() but adds the new listener to the front of the events queue instead of to the end. |
unregister | |
triggerEvent | Trigger a specified registered event. |
clearMouseCache | Clear cached data about the mouse position. |
{Boolean} Should the .xy property automatically be created for browser mouse events? In general, this should be false. If it is true, then mouse events will automatically generate a ‘.xy’ property on the event object that is passed. (Prior to OpenLayers 2.7, this was true by default.) Otherwise, you can call the getMousePosition on the relevant events handler on the object available via the ‘evt.object’ property of the evt object. So, for most events, you can call: function named(evt) { this.xy = this.object.events.getMousePosition(evt) }
when creating an events object whose primary purpose is to manage relatively positioned mouse events within a div, it may make sense to set it to true.
This option is also used to control whether the events object caches offsets. If this is false, it will not: the reason for this is that it is only expected to be called many times if the includeXY property is set to true. If you set this to true, you are expected to clear the offset cache manually (using this.clearMouseCache()) if: the border of the element changes the location of the element in the page changes
Construct an OpenLayers.Events object.
object | {Object} The js object to which this Events object is being |
added element | {DOMElement} A dom element to respond to browser events |
eventTypes | {Array(String)} Array of custom application events |
fallThrough | {Boolean} Allow events to fall through after these have been handled? |
options | {Object} Options for the events object. |
register: function ( type, obj, func )
Register an event on the events object.
When the event is triggered, the ‘func’ function will be called, in the context of ‘obj’. Imagine we were to register an event, specifying an OpenLayers.Bounds Object as ‘obj’. When the event is triggered, the context in the callback function will be our Bounds object. This means that within our callback function, we can access the properties and methods of the Bounds object through the “this” variable. So our callback could execute something like:
leftStr = "Left: " + this.left;
or
centerStr = "Center: " + this.getCenterLonLat();
type | {String} Name of the event to register |
obj | {Object} The object to bind the context to for the callback#. If no object is specified, default is the Events’s ‘object’ property. |
func | {Function} The callback function. If no callback is specified, this function does nothing. |
registerPriority: function ( type, obj, func )
Same as register() but adds the new listener to the front of the events queue instead of to the end.
TODO: get rid of this in 3.0 | Decide whether listeners should be called in the order they were registered or in reverse order. |
type | {String} Name of the event to register |
obj | {Object} The object to bind the context to for the callback#. If no object is specified, default is the Events’s ‘object’ property. |
func | {Function} The callback function. If no callback is specified, this function does nothing. |
destroy: function ()
Add a new event type to this events object.
addEventType: function( eventName )
Register an event on the events object.
register: function ( type, obj, func )
Same as register() but adds the new listener to the front of the events queue instead of to the end.
registerPriority: function ( type, obj, func )
unregister: function ( type, obj, func )
Trigger a specified registered event.
triggerEvent: function ( type, evt )
Clear cached data about the mouse position.
clearMouseCache: function()