Upgrade to ExtJS 3.3.1 - Released 11/30/2010

[extjs.git] / docs / source / Button.html
diff --git a/docs/source/Button.html b/docs/source/Button.html

index 60d5d81..d7f5905 100644 (file)
--- a/docs/source/Button.html
+++ b/docs/source/Button.html
@@ -7,10 +7,10 @@
  </head>
  <body  onload="prettyPrint();">
      <pre class="prettyprint lang-js">/*!
- * Ext JS Library 3.2.0
- * Copyright(c) 2006-2010 Ext JS, Inc.
- * licensing@extjs.com
- * http://www.extjs.com/license
+ * Ext JS Library 3.3.1
+ * Copyright(c) 2006-2010 Sencha Inc.
+ * licensing@sencha.com
+ * http://www.sencha.com/license
   */
  <div id="cls-Ext.Button"></div>/**
   * @class Ext.Button
@@ -193,8 +193,20 @@ Ext.Button = Ext.extend(Ext.BoxComponent, {
       * @type Menu
       * The {@link Ext.menu.Menu Menu} object associated with this Button when configured with the {@link #menu} config option.
       */
+    /**
+     * @cfg {Boolean} autoWidth
+     * By default, if a width is not specified the button will attempt to stretch horizontally to fit its content.
+     * If the button is being managed by a width sizing layout (hbox, fit, anchor), set this to false to prevent
+     * the button from doing this automatic sizing.
+     * Defaults to <tt>undefined</tt>.
+     */
  
      initComponent : function(){
+        if(this.menu){
+            this.menu = Ext.menu.MenuMgr.get(this.menu);
+            this.menu.ownerCt = this;
+        }
+        
          Ext.Button.superclass.initComponent.call(this);
  
          this.addEvents(
@@ -257,8 +269,9 @@ Ext.Button = Ext.extend(Ext.BoxComponent, {
               */
              'menutriggerout'
          );
-        if(this.menu){
-            this.menu = Ext.menu.MenuMgr.get(this.menu);
+        
+        if (this.menu){
+            this.menu.ownerCt = undefined;
          }
          if(Ext.isString(this.toggleGroup)){
              this.enableToggle = true;
@@ -290,7 +303,7 @@ Ext.Button = Ext.extend(Ext.BoxComponent, {
              if(!Ext.isEmpty(this.oldCls)){
                  this.el.removeClass([this.oldCls, 'x-btn-pressed']);
              }
-            this.oldCls = (this.iconCls || this.icon) ? (this.text ? ' x-btn-text-icon' : ' x-btn-icon') : ' x-btn-noicon';
+            this.oldCls = (this.iconCls || this.icon) ? (this.text ? 'x-btn-text-icon' : 'x-btn-icon') : 'x-btn-noicon';
              this.el.addClass([this.oldCls, this.pressed ? 'x-btn-pressed' : null]);
          }
      },
@@ -375,9 +388,10 @@ Ext.Button = Ext.extend(Ext.BoxComponent, {
  
          if(this.repeat){
              var repeater = new Ext.util.ClickRepeater(btn, Ext.isObject(this.repeat) ? this.repeat : {});
-            this.mon(repeater, 'click', this.onClick, this);
+            this.mon(repeater, 'click', this.onRepeatClick, this);
+        }else{
+            this.mon(btn, this.clickEvent, this.onClick, this);
          }
-        this.mon(btn, this.clickEvent, this.onClick, this);
      },
  
      // private
@@ -445,7 +459,7 @@ Ext.Button = Ext.extend(Ext.BoxComponent, {
              this.clearTip();
          }
          if(this.menu && this.destroyMenu !== false) {
-            Ext.destroy(this.menu);
+            Ext.destroy(this.btnEl, this.menu);
          }
          Ext.destroy(this.repeater);
      },
@@ -464,7 +478,7 @@ Ext.Button = Ext.extend(Ext.BoxComponent, {
  
      // private
      doAutoWidth : function(){
-        if(this.el && this.text && this.width === undefined){
+        if(this.autoWidth !== false && this.el && this.text && this.width === undefined){
              this.el.setWidth('auto');
              if(Ext.isIE7 && Ext.isStrict){
                  var ib = this.btnEl;
@@ -609,6 +623,11 @@ Ext.Button = Ext.extend(Ext.BoxComponent, {
      hasVisibleMenu : function(){
          return this.menu && this.menu.ownerCt == this && this.menu.isVisible();
      },
+    
+    // private
+    onRepeatClick : function(repeat, e){
+        this.onClick(e);
+    },
  
      // private
      onClick : function(e){
@@ -619,9 +638,7 @@ Ext.Button = Ext.extend(Ext.BoxComponent, {
              return;
          }
          if(!this.disabled){
-            if(this.enableToggle && (this.allowDepress !== false || !this.pressed)){
-                this.toggle();
-            }
+            this.doToggle();
              if(this.menu && !this.hasVisibleMenu() && !this.ignoreNextClick){
                  this.showMenu();
              }
@@ -632,6 +649,13 @@ Ext.Button = Ext.extend(Ext.BoxComponent, {
              }
          }
      },
+    
+    // private
+    doToggle: function(){
+        if (this.enableToggle && (this.allowDepress !== false || !this.pressed)) {
+            this.toggle();
+        }
+    },
  
      // private
      isMenuTriggerOver : function(e, internal){