$rootScope.Scope.$on()

Listens on events of a given type. See $emit for discussion of event life cycle.

The event listener function format is: function(event, args...). The event object passed into the listener has the following attributes:

• targetScope - {Scope}: the scope on which the event was $emit-ed or $broadcast-ed.
• currentScope - {Scope}: the scope that is currently handling the event. Once the event propagates through the scope hierarchy, this property is set to null.
• name - {string}: name of the event.
• stopPropagation - {function=}: calling stopPropagation function will cancel further event propagation (available only for events that were $emit-ed).
• preventDefault - {function}: calling preventDefault sets defaultPrevented flag to true.
• defaultPrevented - {boolean}: true if preventDefault was called.