Upgrade to ExtJS 3.3.0 - Released 10/06/2010
[extjs.git] / src / widgets / menu / ColorMenu.js
index 15aa402..28069fd 100644 (file)
 /*!
 /*!
- * Ext JS Library 3.1.0
- * Copyright(c) 2006-2009 Ext JS, LLC
+ * Ext JS Library 3.3.0
+ * Copyright(c) 2006-2010 Ext JS, Inc.
  * licensing@extjs.com
  * http://www.extjs.com/license
  */
  * licensing@extjs.com
  * http://www.extjs.com/license
  */
-/**\r
- * @class Ext.menu.ColorMenu\r
- * @extends Ext.menu.Menu\r
- * <p>A menu containing a {@link Ext.ColorPalette} Component.</p>\r
- * <p>Notes:</p><div class="mdetail-params"><ul>\r
- * <li>Although not listed here, the <b>constructor</b> for this class\r
- * accepts all of the configuration options of <b>{@link Ext.ColorPalette}</b>.</li>\r
- * <li>If subclassing ColorMenu, any configuration options for the ColorPalette must be\r
- * applied to the <tt><b>initialConfig</b></tt> property of the ColorMenu.\r
- * Applying {@link Ext.ColorPalette ColorPalette} configuration settings to\r
- * <b><tt>this</tt></b> will <b>not</b> affect the ColorPalette's configuration.</li>\r
- * </ul></div> * \r
- * @xtype colormenu\r
- */\r
- Ext.menu.ColorMenu = Ext.extend(Ext.menu.Menu, {\r
-    /** \r
-     * @cfg {Boolean} enableScrolling\r
-     * @hide \r
-     */\r
-    enableScrolling : false,\r
-    /**\r
-     * @cfg {Function} handler\r
-     * Optional. A function that will handle the select event of this menu.\r
-     * The handler is passed the following parameters:<div class="mdetail-params"><ul>\r
-     * <li><code>palette</code> : ColorPalette<div class="sub-desc">The {@link #palette Ext.ColorPalette}.</div></li>\r
-     * <li><code>color</code> : String<div class="sub-desc">The 6-digit color hex code (without the # symbol).</div></li>\r
-     * </ul></div>\r
-     */\r
-    /**\r
-     * @cfg {Object} scope\r
-     * The scope (<tt><b>this</b></tt> reference) in which the <code>{@link #handler}</code>\r
-     * function will be called.  Defaults to this ColorMenu instance.\r
-     */    \r
-    \r
-    /** \r
-     * @cfg {Boolean} hideOnClick\r
-     * False to continue showing the menu after a color is selected, defaults to true.\r
-     */\r
-    hideOnClick : true,\r
-    \r
-    cls : 'x-color-menu',\r
-    \r
-    /** \r
-     * @cfg {String} paletteId\r
-     * An id to assign to the underlying color palette. Defaults to <tt>null</tt>.\r
-     */\r
-    paletteId : null,\r
-    \r
-    /** \r
-     * @cfg {Number} maxHeight\r
-     * @hide \r
-     */\r
-    /** \r
-     * @cfg {Number} scrollIncrement\r
-     * @hide \r
-     */\r
-    /**\r
-     * @property palette\r
-     * @type ColorPalette\r
-     * The {@link Ext.ColorPalette} instance for this ColorMenu\r
-     */\r
-    \r
-    \r
-    /**\r
-     * @event click\r
-     * @hide\r
-     */\r
-    \r
-    /**\r
-     * @event itemclick\r
-     * @hide\r
-     */\r
-    \r
-    initComponent : function(){\r
-        Ext.apply(this, {\r
-            plain: true,\r
-            showSeparator: false,\r
-            items: this.palette = new Ext.ColorPalette(Ext.applyIf({\r
-                id: this.paletteId\r
-            }, this.initialConfig))\r
-        });\r
-        this.palette.purgeListeners();\r
-        Ext.menu.ColorMenu.superclass.initComponent.call(this);\r
-        /**\r
-         * @event select\r
-         * Fires when a color is selected from the {@link #palette Ext.ColorPalette}\r
-         * @param {Ext.ColorPalette} palette The {@link #palette Ext.ColorPalette}\r
-            * @param {String} color The 6-digit color hex code (without the # symbol)\r
-         */\r
-        this.relayEvents(this.palette, ['select']);\r
-        this.on('select', this.menuHide, this);\r
-        if(this.handler){\r
-            this.on('select', this.handler, this.scope || this);\r
-        }\r
-    },\r
-\r
-    menuHide : function(){\r
-        if(this.hideOnClick){\r
-            this.hide(true);\r
-        }\r
-    }\r
-});\r
-Ext.reg('colormenu', Ext.menu.ColorMenu);\r
+/**
+ * @class Ext.menu.ColorMenu
+ * @extends Ext.menu.Menu
+ * <p>A menu containing a {@link Ext.ColorPalette} Component.</p>
+ * <p>Notes:</p><div class="mdetail-params"><ul>
+ * <li>Although not listed here, the <b>constructor</b> for this class
+ * accepts all of the configuration options of <b>{@link Ext.ColorPalette}</b>.</li>
+ * <li>If subclassing ColorMenu, any configuration options for the ColorPalette must be
+ * applied to the <tt><b>initialConfig</b></tt> property of the ColorMenu.
+ * Applying {@link Ext.ColorPalette ColorPalette} configuration settings to
+ * <b><tt>this</tt></b> will <b>not</b> affect the ColorPalette's configuration.</li>
+ * </ul></div> * 
+ * @xtype colormenu
+ */
+ Ext.menu.ColorMenu = Ext.extend(Ext.menu.Menu, {
+    /** 
+     * @cfg {Boolean} enableScrolling
+     * @hide 
+     */
+    enableScrolling : false,
+    /**
+     * @cfg {Function} handler
+     * Optional. A function that will handle the select event of this menu.
+     * The handler is passed the following parameters:<div class="mdetail-params"><ul>
+     * <li><code>palette</code> : ColorPalette<div class="sub-desc">The {@link #palette Ext.ColorPalette}.</div></li>
+     * <li><code>color</code> : String<div class="sub-desc">The 6-digit color hex code (without the # symbol).</div></li>
+     * </ul></div>
+     */
+    /**
+     * @cfg {Object} scope
+     * The scope (<tt><b>this</b></tt> reference) in which the <code>{@link #handler}</code>
+     * function will be called.  Defaults to this ColorMenu instance.
+     */    
+    
+    /** 
+     * @cfg {Boolean} hideOnClick
+     * False to continue showing the menu after a color is selected, defaults to true.
+     */
+    hideOnClick : true,
+    
+    cls : 'x-color-menu',
+    
+    /** 
+     * @cfg {String} paletteId
+     * An id to assign to the underlying color palette. Defaults to <tt>null</tt>.
+     */
+    paletteId : null,
+    
+    /** 
+     * @cfg {Number} maxHeight
+     * @hide 
+     */
+    /** 
+     * @cfg {Number} scrollIncrement
+     * @hide 
+     */
+    /**
+     * @property palette
+     * @type ColorPalette
+     * The {@link Ext.ColorPalette} instance for this ColorMenu
+     */
+    
+    
+    /**
+     * @event click
+     * @hide
+     */
+    
+    /**
+     * @event itemclick
+     * @hide
+     */
+    
+    initComponent : function(){
+        Ext.apply(this, {
+            plain: true,
+            showSeparator: false,
+            items: this.palette = new Ext.ColorPalette(Ext.applyIf({
+                id: this.paletteId
+            }, this.initialConfig))
+        });
+        this.palette.purgeListeners();
+        Ext.menu.ColorMenu.superclass.initComponent.call(this);
+        /**
+         * @event select
+         * Fires when a color is selected from the {@link #palette Ext.ColorPalette}
+         * @param {Ext.ColorPalette} palette The {@link #palette Ext.ColorPalette}
+            * @param {String} color The 6-digit color hex code (without the # symbol)
+         */
+        this.relayEvents(this.palette, ['select']);
+        this.on('select', this.menuHide, this);
+        if(this.handler){
+            this.on('select', this.handler, this.scope || this);
+        }
+    },
+
+    menuHide : function(){
+        if(this.hideOnClick){
+            this.hide(true);
+        }
+    }
+});
+Ext.reg('colormenu', Ext.menu.ColorMenu);