Upgrade to ExtJS 3.2.1 - Released 04/27/2010
[extjs.git] / docs / source / ComponentMgr.html
index e894bf9..8c4db2b 100644 (file)
@@ -1,13 +1,14 @@
 <html>
 <head>
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />    
   <title>The source code</title>
     <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />
     <script type="text/javascript" src="../resources/prettify/prettify.js"></script>
 </head>
 <body  onload="prettyPrint();">
     <pre class="prettyprint lang-js">/*!
- * Ext JS Library 3.0.3
- * Copyright(c) 2006-2009 Ext JS, LLC
+ * Ext JS Library 3.2.1
+ * Copyright(c) 2006-2010 Ext JS, Inc.
  * licensing@extjs.com
  * http://www.extjs.com/license
  */
@@ -60,10 +61,10 @@ Ext.ComponentMgr = function(){
         },
 
         <div id="method-Ext.ComponentMgr-onAvailable"></div>/**
-         * Registers a function that will be called when a specified component is added to ComponentMgr
+         * Registers a function that will be called when a Component with the specified id is added to ComponentMgr. This will happen on instantiation.
          * @param {String} id The component {@link Ext.Component#id id}
          * @param {Function} fn The callback function
-         * @param {Object} scope The scope of the callback
+         * @param {Object} scope The scope (<code>this</code> reference) in which the callback is executed. Defaults to the Component.
          */
         onAvailable : function(id, fn, scope){
             all.on("add", function(index, o){
@@ -81,6 +82,18 @@ Ext.ComponentMgr = function(){
          */
         all : all,
         
+        <div id="prop-Ext.ComponentMgr-types"></div>/**
+         * The xtypes that have been registered with the component manager.
+         * @type {Object}
+         */
+        types : types,
+        
+        <div id="prop-Ext.ComponentMgr-ptypes"></div>/**
+         * The ptypes that have been registered with the component manager.
+         * @type {Object}
+         */
+        ptypes: ptypes,
+        
         <div id="method-Ext.ComponentMgr-isRegistered"></div>/**
          * Checks if a Component type is registered.
          * @param {Ext.Component} xtype The mnemonic string by which the Component class may be looked up
@@ -89,6 +102,15 @@ Ext.ComponentMgr = function(){
         isRegistered : function(xtype){
             return types[xtype] !== undefined;    
         },
+        
+        <div id="method-Ext.ComponentMgr-isPluginRegistered"></div>/**
+         * Checks if a Plugin type is registered.
+         * @param {Ext.Component} ptype The mnemonic string by which the Plugin class may be looked up
+         * @return {Boolean} Whether the type is registered.
+         */
+        isPluginRegistered : function(ptype){
+            return ptypes[ptype] !== undefined;    
+        },        
 
         <div id="method-Ext.ComponentMgr-registerType"></div>/**
          * <p>Registers a new Component constructor, keyed by a new
@@ -140,7 +162,12 @@ Ext.ComponentMgr = function(){
          * @return {Ext.Component} The newly instantiated Plugin.
          */
         createPlugin : function(config, defaultType){
-            return new ptypes[config.ptype || defaultType](config);
+            var PluginCls = ptypes[config.ptype || defaultType];
+            if (PluginCls.init) {
+                return PluginCls;                
+            } else {
+                return new PluginCls(config);
+            }            
         }
     };
 }();
@@ -174,6 +201,6 @@ Ext.preg = Ext.ComponentMgr.registerPlugin;
  * @member Ext
  * @method create
  */
-Ext.create = Ext.ComponentMgr.create;</pre>
+Ext.create = Ext.ComponentMgr.create;</pre>    
 </body>
 </html>
\ No newline at end of file