LzNotifyingEvent

An enhanced event.

Extends LzEvent

In some cases, an object which publishes an event needs to know when delegates register and unregister for that event. Notifying events serve this purpose, and they send events when delegates register or unregister with them. This can be used to optimize subsystems when they are not in use. Unlike regular events, notifying events are created using the new keyword. In all other respects, notifying events are the same as regular events.

Attributes
Name Usage Type (Tag) Type (JS) Default Category
frame JS only   readonly
  See also the resource attribute. Setting this attribute will change the frame that is being displayed by the resource associated with this view. The first frame of the resource is frame 0. Setting a view's 'donttrackplay' option to true will allow the view's resource to play without updating the value of the view's frame property. This can save CPU usage in cases where the application doesn't need to know what frame the resource is showing while it is playing. Removed "at" sign from the line below so that this field does not appear in the documentation. field selected: Setting this attribute calls the abstract method setSelected. See LzSelectionManager.

mask JS only LzView   readonly
  Reference to closest masked view in the hierarchy above this one

notifyingDelegate JS only LzDelegate   readonly
  The delegate which will be called (with the number of currently registered delegates) when a delegate registers or unregisters for the event.

source JS only   readonly
  The URL from which to load the resource for this view. If this attribute is set, the media for the view is loaded at runtime.


Attributes inherited from LzEvent

locked


Methods

addDelegate()
LzNotifyingEvent.addDelegate(d)

Calls the inherited method and also calls the notifyingDelegate with the length of the delegateList as the data.

Parameters
Name Type Desc
d LzDelegate The delegate to add to the delegateList


constructor()
LzNotifyingEvent(eventSender, eventName, d)

A notifying event calls a delegate when it gets called for registration or removal. This helps an object keep track of whether or not they need to be sending an event that can be expensive to monitor (such as Flash's text focus.)

Parameters
Name Type Desc
eventSender Object The object which publishes the event.
eventName String The name of the event to register for.
d LzDelegate The delegate to call when the event registers or unregisters a delegate.


removeDelegate()
LzNotifyingEvent.removeDelegate(d)

Calls the inherited method and also calls the notifyingDelegate with the length of the delegateList as the data.

Parameters
Name Type Desc
d LzDelegate The delegate to remove from the delegateList


Methods inherited from LzEvent

addDelegate, clearDelegates, constructor, getDelegateCount, removeDelegate, sendEvent


Events
Name Description
onaddsubview None
onblur None
onfocus None
onheight None
onremovesubview None
onwidth None
onx None
ony None