Device

Common API for document window size change notifications across all platforms.

Field Summary

heightThe current height of the document's window in pixels.

widthThe current width of the document's window in pixels.

Method Summary

attachHandler(fnFunction, oListener?)Registers the given event handler to resize change events of the document's window.

detachHandler(fnFunction, oListener?)Removes a previously attached event handler from the resize events.

Field Detail

height: integer

The current height of the document's window in pixels.

width: integer

The current width of the document's window in pixels.

Method Detail

attachHandler(fnFunction, oListener?)

Registers the given event handler to resize change events of the document's window.

The event is fired whenever the document's window size changes.

The event handler is called with a single argument: a map mParams which provides the following information:

Parameters:

{function}	fnFunction	The handler function to call when the event occurs. This function will be called in the context of the `oListener` instance (if present) or on the `window` instance. A map with information about the size is provided as a single argument to the handler (see details above).
{object}	oListener?	The object that wants to be notified when the event occurs (`this` context within the handler function). If it is not specified, the handler function is called in the context of the `window`.

detachHandler(fnFunction, oListener?)

Removes a previously attached event handler from the resize events.

The passed parameters must match those used for registration with attachHandler beforehand.

Parameters:

{function}	fnFunction	The handler function to detach from the event
{object}	oListener?	The object that wanted to be notified when the event occurred