Upgrade to ExtJS 4.0.7 - Released 10/19/2011

[extjs.git] / src / app / EventBus.js

diff --git a/src/app/EventBus.js b/src/app/EventBus.js
index 212523c..177a9dd 100644 (file)
--- a/src/app/EventBus.js
+++ b/src/app/EventBus.js
@@ -1,9 +1,20 @@
+/*
+
+This file is part of Ext JS 4
+
+Copyright (c) 2011 Sencha Inc
+
+Contact:  http://www.sencha.com/contact
+
+GNU General Public License Usage
+This file may be used under the terms of the GNU General Public License version 3.0 as published by the Free Software Foundation and appearing in the file LICENSE included in the packaging of this file.  Please review the following information to ensure the GNU General Public License version 3.0 requirements will be met: http://www.gnu.org/copyleft/gpl.html.
+
+If you are unsure which license is appropriate for your use, please contact the sales department at http://www.sencha.com/contact.
+
+*/
 /**
  * @class Ext.app.EventBus
  * @private
- *
- * Class documentation for the MVC classes will be present before 4.0 final, in the mean time please refer to the MVC
- * guide
  */
 Ext.define('Ext.app.EventBus', {
     requires: [
@@ -12,12 +23,12 @@ Ext.define('Ext.app.EventBus', {
     mixins: {
         observable: 'Ext.util.Observable'
     },
-    
+
     constructor: function() {
         this.mixins.observable.constructor.call(this);
-        
+
         this.bus = {};
-        
+
         var me = this;
         Ext.override(Ext.Component, {
             fireEvent: function(ev) {
@@ -33,13 +44,13 @@ Ext.define('Ext.app.EventBus', {
         var bus = this.bus,
             selectors = bus[ev],
             selector, controllers, id, events, event, i, ln;
-        
+
         if (selectors) {
             // Loop over all the selectors that are bound to this event
             for (selector in selectors) {
                 // Check if the target matches the selector
                 if (target.is(selector)) {
-                    // Loop over all the controllers that are bound to this selector   
+                    // Loop over all the controllers that are bound to this selector
                     controllers = selectors[selector];
                     for (id in controllers) {
                         // Loop over all the events that are bound to this selector on this controller
@@ -47,18 +58,20 @@ Ext.define('Ext.app.EventBus', {
                         for (i = 0, ln = events.length; i < ln; i++) {
                             event = events[i];
                             // Fire the event!
-                            return event.fire.apply(event, Array.prototype.slice.call(args, 1));
+                            if (event.fire.apply(event, Array.prototype.slice.call(args, 1)) === false) {
+                                return false;
+                            };
                         }
                     }
                 }
             }
         }
     },
-    
+
     control: function(selectors, listeners, controller) {
         var bus = this.bus,
             selector, fn;
-        
+
         if (Ext.isString(selectors)) {
             selector = selectors;
             selectors = {};
@@ -66,14 +79,14 @@ Ext.define('Ext.app.EventBus', {
             this.control(selectors, null, controller);
             return;
         }
-    
+
         Ext.Object.each(selectors, function(selector, listeners) {
             Ext.Object.each(listeners, function(ev, listener) {
-                var options = {},   
+                var options = {},
                     scope = controller,
                     event = Ext.create('Ext.util.Event', controller, ev);
-                
-                // Normalize the listener                
+
+                // Normalize the listener
                 if (Ext.isObject(listener)) {
                     options = listener;
                     listener = options.fn;
@@ -81,17 +94,17 @@ Ext.define('Ext.app.EventBus', {
                     delete options.fn;
                     delete options.scope;
                 }
-                
+
                 event.addListener(listener, scope, options);
 
                 // Create the bus tree if it is not there yet
                 bus[ev] = bus[ev] || {};
                 bus[ev][selector] = bus[ev][selector] || {};
-                bus[ev][selector][controller.id] = bus[ev][selector][controller.id] || [];            
-                
+                bus[ev][selector][controller.id] = bus[ev][selector][controller.id] || [];
+
                 // Push our listener in our bus
                 bus[ev][selector][controller.id].push(event);
             });
         });
     }
-});
\ No newline at end of file
+});