Upgrade to ExtJS 4.0.2 - Released 06/09/2011
[extjs.git] / docs / output / Ext.layout.container.Column.js
index 018c032..4fa6098 100644 (file)
 Ext.data.JsonP.Ext_layout_container_Column({
-  "tagname": "class",
-  "name": "Ext.layout.container.Column",
-  "doc": "<p>This is the layout style of choice for creating structural layouts in a multi-column format where the width of\neach column can be specified as a percentage or fixed width, but the height is allowed to vary based on the content.\nThis class is intended to be extended or created via the layout:'column' <a href=\"#/api/Ext.container.Container-cfg-layout\" rel=\"Ext.container.Container-cfg-layout\" class=\"docClass\">Ext.container.Container.layout</a> config,\nand should generally not need to be created directly via the new keyword.</p>\n\n\n<p>ColumnLayout does not have any direct config options (other than inherited ones), but it does support a\nspecific config property of <b><tt>columnWidth</tt></b> that can be included in the config of any panel added to it.  The\nlayout will use the columnWidth (if present) or width of each panel during layout to determine how to size each panel.\nIf width or columnWidth is not specified for a given panel, its width will default to the panel's width (or auto).</p>\n\n\n<p>The width property is always evaluated as pixels, and must be a number greater than or equal to 1.\nThe columnWidth property is always evaluated as a percentage, and must be a decimal value greater than 0 and\nless than 1 (e.g., .25).</p>\n\n\n<p>The basic rules for specifying column widths are pretty simple.  The logic makes two passes through the\nset of contained panels.  During the first layout pass, all panels that either have a fixed width or none\nspecified (auto) are skipped, but their widths are subtracted from the overall container width.  During the second\npass, all panels with columnWidths are assigned pixel widths in proportion to their percentages based on\nthe total <b>remaining</b> container width.  In other words, percentage width panels are designed to fill the space\nleft over by all the fixed-width and/or auto-width panels.  Because of this, while you can specify any number of columns\nwith different percentages, the columnWidths must always add up to 1 (or 100%) when added together, otherwise your\nlayout may not render as expected.  \n<p><img src=\"doc-resources/Ext.layout.container.Column/Ext.layout.container.Column1.png\" alt=\"Ext.layout.container.Column container layout\"></p>\nExample usage:</p>\n\n\n<pre><code>    // All columns are percentages -- they must add up to 1\n    Ext.create('Ext.panel.Panel', {\n        title: 'Column Layout - Percentage Only',\n        width: 350,\n        height: 250,\n        layout:'column',\n        items: [{\n            title: 'Column 1',\n            columnWidth: .25\n        },{\n            title: 'Column 2',\n            columnWidth: .55\n        },{\n            title: 'Column 3',\n            columnWidth: .20\n        }],\n        renderTo: Ext.getBody()\n    }); \n\n// <p><img src=\"doc-resources/Ext.layout.container.Column/Ext.layout.container.Column2.png\" alt=\"Ext.layout.container.Column container layout\"></p>\n// Mix of width and columnWidth -- all columnWidth values must add up\n// to 1. The first column will take up exactly 120px, and the last two\n// columns will fill the remaining container width.\n\n    Ext.create('Ext.Panel', {\n        title: 'Column Layout - Mixed',\n        width: 350,\n        height: 250,\n        layout:'column',\n        items: [{\n            title: 'Column 1',\n            width: 120\n        },{\n            title: 'Column 2',\n            columnWidth: .7\n        },{\n            title: 'Column 3',\n            columnWidth: .3\n        }],\n        renderTo: Ext.getBody()\n    }); \n</code></pre>\n\n",
-  "extends": "Ext.layout.container.Auto",
-  "mixins": [
+  "allMixins": [
 
   ],
-  "alternateClassNames": [
-    "Ext.layout.ColumnLayout"
-  ],
-  "xtype": null,
-  "author": null,
+  "deprecated": null,
   "docauthor": null,
-  "singleton": false,
-  "private": false,
-  "cfg": [
-    {
-      "tagname": "cfg",
-      "name": "bindToOwnerCtComponent",
-      "member": "Ext.layout.container.AbstractContainer",
-      "type": "Boolean",
-      "doc": "<p>Flag to notify the ownerCt Component on afterLayout of a change</p>\n",
-      "private": false,
-      "filename": "/Users/nick/Projects/sencha/SDK/platform/src/layout/container/AbstractContainer.js",
-      "linenr": 24,
-      "html_filename": "AbstractContainer2.html",
-      "href": "AbstractContainer2.html#Ext-layout-container-AbstractContainer-cfg-bindToOwnerCtComponent"
-    },
-    {
-      "tagname": "cfg",
-      "name": "bindToOwnerCtContainer",
-      "member": "Ext.layout.container.AbstractContainer",
-      "type": "Boolean",
-      "doc": "<p>Flag to notify the ownerCt Container on afterLayout of a change</p>\n",
-      "private": false,
-      "filename": "/Users/nick/Projects/sencha/SDK/platform/src/layout/container/AbstractContainer.js",
-      "linenr": 30,
-      "html_filename": "AbstractContainer2.html",
-      "href": "AbstractContainer2.html#Ext-layout-container-AbstractContainer-cfg-bindToOwnerCtContainer"
-    },
-    {
-      "tagname": "cfg",
-      "name": "itemCls",
-      "member": "Ext.layout.container.AbstractContainer",
-      "type": "String",
-      "doc": "<p>An optional extra CSS class that will be added to the container. This can be useful for adding\ncustomized styles to the container or any of its children using standard CSS rules. See\n<a href=\"#/api/Ext.Component\" rel=\"Ext.Component\" class=\"docClass\">Ext.Component</a>.<a href=\"#/api/Ext.Component--ctCls\" rel=\"Ext.Component--ctCls\" class=\"docClass\">ctCls</a> also.</p>\n\n\n<p></p></p>\n",
-      "private": false,
-      "filename": "/Users/nick/Projects/sencha/SDK/platform/src/layout/container/AbstractContainer.js",
-      "linenr": 36,
-      "html_filename": "AbstractContainer2.html",
-      "href": "AbstractContainer2.html#Ext-layout-container-AbstractContainer-cfg-itemCls",
-      "shortDoc": "An optional extra CSS class that will be added to the container. This can be useful for adding\ncustomized styles to t..."
-    }
-  ],
-  "method": [
-    {
-      "tagname": "method",
-      "name": "getLayoutItems",
-      "member": "Ext.layout.container.AbstractContainer",
-      "doc": "<p>Returns an array of child components either for a render phase (Performed in the beforeLayout method of the layout's\nbase class), or the layout phase (onLayout).</p>\n\n",
-      "params": [
+  "members": {
+    "cfg": [
+      {
+        "type": "Boolean",
+        "deprecated": null,
+        "alias": null,
+        "protected": false,
+        "tagname": "cfg",
+        "href": "AbstractContainer.html#Ext-layout-container-AbstractContainer-cfg-bindToOwnerCtComponent",
+        "static": false,
+        "filename": "/mnt/ebs/nightly/git/SDK/platform/src/layout/container/AbstractContainer.js",
+        "private": false,
+        "name": "bindToOwnerCtComponent",
+        "owner": "Ext.layout.container.AbstractContainer",
+        "doc": "<p>Flag to notify the ownerCt Component on afterLayout of a change</p>\n",
+        "linenr": 17,
+        "html_filename": "AbstractContainer.html"
+      },
+      {
+        "type": "Boolean",
+        "deprecated": null,
+        "alias": null,
+        "protected": false,
+        "tagname": "cfg",
+        "href": "AbstractContainer.html#Ext-layout-container-AbstractContainer-cfg-bindToOwnerCtContainer",
+        "static": false,
+        "filename": "/mnt/ebs/nightly/git/SDK/platform/src/layout/container/AbstractContainer.js",
+        "private": false,
+        "name": "bindToOwnerCtContainer",
+        "owner": "Ext.layout.container.AbstractContainer",
+        "doc": "<p>Flag to notify the ownerCt Container on afterLayout of a change</p>\n",
+        "linenr": 23,
+        "html_filename": "AbstractContainer.html"
+      },
+      {
+        "type": "String",
+        "deprecated": null,
+        "alias": null,
+        "protected": false,
+        "tagname": "cfg",
+        "href": "AbstractContainer.html#Ext-layout-container-AbstractContainer-cfg-itemCls",
+        "shortDoc": "An optional extra CSS class that will be added to the container. ...",
+        "static": false,
+        "filename": "/mnt/ebs/nightly/git/SDK/platform/src/layout/container/AbstractContainer.js",
+        "private": false,
+        "name": "itemCls",
+        "owner": "Ext.layout.container.AbstractContainer",
+        "doc": "<p>An optional extra CSS class that will be added to the container. This can be useful for adding\ncustomized styles to the container or any of its children using standard CSS rules. See\n<a href=\"#/api/Ext.Component\" rel=\"Ext.Component\" class=\"docClass\">Ext.Component</a>.ctCls also.</p>\n\n\n<p></p></p>\n",
+        "linenr": 29,
+        "html_filename": "AbstractContainer.html"
+      }
+    ],
+    "method": [
+      {
+        "deprecated": null,
+        "alias": null,
+        "protected": false,
+        "tagname": "method",
+        "href": "AbstractContainer.html#Ext-layout-container-AbstractContainer-method-getLayoutItems",
+        "shortDoc": "Returns an array of child components either for a render phase (Performed in the beforeLayout method of the layout's\n...",
+        "static": false,
+        "filename": "/mnt/ebs/nightly/git/SDK/platform/src/layout/container/AbstractContainer.js",
+        "private": false,
+        "params": [
 
-      ],
-      "return": {
-        "type": "Array",
-        "doc": "<p>of child components</p>\n"
+        ],
+        "name": "getLayoutItems",
+        "owner": "Ext.layout.container.AbstractContainer",
+        "doc": "<p>Returns an array of child components either for a render phase (Performed in the beforeLayout method of the layout's\nbase class), or the layout phase (onLayout).</p>\n\n",
+        "linenr": 49,
+        "return": {
+          "type": "Array",
+          "doc": "<p>of child components</p>\n"
+        },
+        "html_filename": "AbstractContainer.html"
       },
-      "private": false,
-      "static": false,
-      "filename": "/Users/nick/Projects/sencha/SDK/platform/src/layout/container/AbstractContainer.js",
-      "linenr": 87,
-      "html_filename": "AbstractContainer2.html",
-      "href": "AbstractContainer2.html#Ext-layout-container-AbstractContainer-method-getLayoutItems",
-      "shortDoc": "Returns an array of child components either for a render phase (Performed in the beforeLayout method of the layout's\n..."
-    },
-    {
-      "tagname": "method",
-      "name": "getRenderTarget",
-      "member": "Ext.layout.container.AbstractContainer",
-      "doc": "<p>Returns the element into which rendering must take place. Defaults to the owner Container's <a href=\"#/api/Ext.AbstractComponent--targetEl\" rel=\"Ext.AbstractComponent--targetEl\" class=\"docClass\">Ext.AbstractComponent.targetEl</a>.</p>\n\n\n<p>May be overridden in layout managers which implement an inner element.</p>\n",
-      "params": [
+      {
+        "deprecated": null,
+        "alias": null,
+        "protected": false,
+        "tagname": "method",
+        "href": "AbstractContainer.html#Ext-layout-container-AbstractContainer-method-getRenderTarget",
+        "shortDoc": "Returns the element into which rendering must take place. ...",
+        "static": false,
+        "filename": "/mnt/ebs/nightly/git/SDK/platform/src/layout/container/AbstractContainer.js",
+        "private": false,
+        "params": [
 
-      ],
-      "return": {
-        "type": "Ext.core.Element",
-        "doc": "\n"
+        ],
+        "name": "getRenderTarget",
+        "owner": "Ext.layout.container.AbstractContainer",
+        "doc": "<p>Returns the element into which rendering must take place. Defaults to the owner Container's Ext.AbstractComponent.targetEl.</p>\n\n\n<p>May be overridden in layout managers which implement an inner element.</p>\n",
+        "linenr": 68,
+        "return": {
+          "type": "Ext.core.Element",
+          "doc": "\n"
+        },
+        "html_filename": "AbstractContainer.html"
       },
-      "private": false,
-      "static": false,
-      "filename": "/Users/nick/Projects/sencha/SDK/platform/src/layout/container/AbstractContainer.js",
-      "linenr": 106,
-      "html_filename": "AbstractContainer2.html",
-      "href": "AbstractContainer2.html#Ext-layout-container-AbstractContainer-method-getRenderTarget",
-      "shortDoc": "Returns the element into which rendering must take place. Defaults to the owner Container's Ext.AbstractComponent.tar..."
-    },
-    {
-      "tagname": "method",
-      "name": "getTarget",
-      "member": "Ext.layout.container.AbstractContainer",
-      "doc": "<p>Returns the owner component's resize element.</p>\n",
-      "params": [
+      {
+        "deprecated": null,
+        "alias": null,
+        "protected": true,
+        "tagname": "method",
+        "href": "Container.html#Ext-layout-container-Container-method-getRenderedItems",
+        "shortDoc": "Returns all items that are rendered ...",
+        "static": false,
+        "filename": "/mnt/ebs/nightly/git/SDK/extjs/src/layout/container/Container.js",
+        "private": false,
+        "params": [
 
-      ],
-      "return": {
-        "type": "Ext.core.Element",
-        "doc": "\n"
+        ],
+        "name": "getRenderedItems",
+        "owner": "Ext.layout.container.Container",
+        "doc": "<p>Returns all items that are rendered</p>\n",
+        "linenr": 53,
+        "return": {
+          "type": "Array",
+          "doc": "<p>All matching items</p>\n"
+        },
+        "html_filename": "Container.html"
       },
-      "private": false,
-      "static": false,
-      "filename": "/Users/nick/Projects/sencha/SDK/platform/src/layout/container/AbstractContainer.js",
-      "linenr": 99,
-      "html_filename": "AbstractContainer2.html",
-      "href": "AbstractContainer2.html#Ext-layout-container-AbstractContainer-method-getTarget",
-      "shortDoc": "<p>Returns the owner component's resize element.</p>\n"
-    }
-  ],
-  "property": [
+      {
+        "deprecated": null,
+        "alias": null,
+        "protected": false,
+        "tagname": "method",
+        "href": "AbstractContainer.html#Ext-layout-container-AbstractContainer-method-getTarget",
+        "shortDoc": "Returns the owner component's resize element. ...",
+        "static": false,
+        "filename": "/mnt/ebs/nightly/git/SDK/platform/src/layout/container/AbstractContainer.js",
+        "private": false,
+        "params": [
 
-  ],
-  "event": [
+        ],
+        "name": "getTarget",
+        "owner": "Ext.layout.container.AbstractContainer",
+        "doc": "<p>Returns the owner component's resize element.</p>\n",
+        "linenr": 61,
+        "return": {
+          "type": "Ext.core.Element",
+          "doc": "\n"
+        },
+        "html_filename": "AbstractContainer.html"
+      },
+      {
+        "deprecated": null,
+        "alias": null,
+        "protected": true,
+        "tagname": "method",
+        "href": "Container.html#Ext-layout-container-Container-method-getVisibleItems",
+        "shortDoc": "Returns all items that are both rendered and visible ...",
+        "static": false,
+        "filename": "/mnt/ebs/nightly/git/SDK/extjs/src/layout/container/Container.js",
+        "private": false,
+        "params": [
 
-  ],
-  "filename": "/Users/nick/Projects/sencha/SDK/extjs/src/layout/container/Column.js",
-  "linenr": 1,
-  "html_filename": "Column2.html",
-  "href": "Column2.html#Ext-layout-container-Column",
-  "cssVar": [
+        ],
+        "name": "getVisibleItems",
+        "owner": "Ext.layout.container.Container",
+        "doc": "<p>Returns all items that are both rendered and visible</p>\n",
+        "linenr": 76,
+        "return": {
+          "type": "Array",
+          "doc": "<p>All matching items</p>\n"
+        },
+        "html_filename": "Container.html"
+      }
+    ],
+    "property": [
 
-  ],
-  "cssMixin": [
+    ],
+    "cssVar": [
 
-  ],
-  "component": false,
+    ],
+    "cssMixin": [
+
+    ],
+    "event": [
+
+    ]
+  },
+  "singleton": false,
+  "alias": null,
   "superclasses": [
     "Ext.layout.Layout",
     "Ext.layout.container.AbstractContainer",
     "Ext.layout.container.Container",
     "Ext.layout.container.Auto"
   ],
+  "protected": false,
+  "tagname": "class",
+  "mixins": [
+
+  ],
+  "href": "Column.html#Ext-layout-container-Column",
   "subclasses": [
 
   ],
+  "static": false,
+  "author": null,
+  "component": false,
+  "filename": "/mnt/ebs/nightly/git/SDK/extjs/src/layout/container/Column.js",
+  "private": false,
+  "alternateClassNames": [
+    "Ext.layout.ColumnLayout"
+  ],
+  "name": "Ext.layout.container.Column",
+  "doc": "<p>This is the layout style of choice for creating structural layouts in a multi-column format where the width of\neach column can be specified as a percentage or fixed width, but the height is allowed to vary based on the content.\nThis class is intended to be extended or created via the layout:'column' <a href=\"#/api/Ext.container.Container-cfg-layout\" rel=\"Ext.container.Container-cfg-layout\" class=\"docClass\">Ext.container.Container.layout</a> config,\nand should generally not need to be created directly via the new keyword.</p>\n\n\n<p>ColumnLayout does not have any direct config options (other than inherited ones), but it does support a\nspecific config property of <b><tt>columnWidth</tt></b> that can be included in the config of any panel added to it.  The\nlayout will use the columnWidth (if present) or width of each panel during layout to determine how to size each panel.\nIf width or columnWidth is not specified for a given panel, its width will default to the panel's width (or auto).</p>\n\n\n<p>The width property is always evaluated as pixels, and must be a number greater than or equal to 1.\nThe columnWidth property is always evaluated as a percentage, and must be a decimal value greater than 0 and\nless than 1 (e.g., .25).</p>\n\n\n<p>The basic rules for specifying column widths are pretty simple.  The logic makes two passes through the\nset of contained panels.  During the first layout pass, all panels that either have a fixed width or none\nspecified (auto) are skipped, but their widths are subtracted from the overall container width.  During the second\npass, all panels with columnWidths are assigned pixel widths in proportion to their percentages based on\nthe total <b>remaining</b> container width.  In other words, percentage width panels are designed to fill the space\nleft over by all the fixed-width and/or auto-width panels.  Because of this, while you can specify any number of columns\nwith different percentages, the columnWidths must always add up to 1 (or 100%) when added together, otherwise your\nlayout may not render as expected.  \n<p><img src=\"doc-resources/Ext.layout.container.Column/Ext.layout.container.Column1.png\" alt=\"Ext.layout.container.Column container layout\"></p>\nExample usage:</p>\n\n\n<pre><code>    // All columns are percentages -- they must add up to 1\n    Ext.create('Ext.panel.Panel', {\n        title: 'Column Layout - Percentage Only',\n        width: 350,\n        height: 250,\n        layout:'column',\n        items: [{\n            title: 'Column 1',\n            columnWidth: .25\n        },{\n            title: 'Column 2',\n            columnWidth: .55\n        },{\n            title: 'Column 3',\n            columnWidth: .20\n        }],\n        renderTo: Ext.getBody()\n    }); \n\n// <p><img src=\"doc-resources/Ext.layout.container.Column/Ext.layout.container.Column2.png\" alt=\"Ext.layout.container.Column container layout\"></p>\n// Mix of width and columnWidth -- all columnWidth values must add up\n// to 1. The first column will take up exactly 120px, and the last two\n// columns will fill the remaining container width.\n\n    Ext.create('Ext.Panel', {\n        title: 'Column Layout - Mixed',\n        width: 350,\n        height: 250,\n        layout:'column',\n        items: [{\n            title: 'Column 1',\n            width: 120\n        },{\n            title: 'Column 2',\n            columnWidth: .7\n        },{\n            title: 'Column 3',\n            columnWidth: .3\n        }],\n        renderTo: Ext.getBody()\n    }); \n</code></pre>\n\n",
   "mixedInto": [
 
   ],
-  "allMixins": [
+  "linenr": 1,
+  "xtypes": [
 
-  ]
+  ],
+  "html_filename": "Column.html",
+  "extends": "Ext.layout.container.Auto"
 });
\ No newline at end of file