/*
This file is part of Ext JS 4.2
Copyright (c) 2011-2013 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.
Build date: 2013-05-16 14:36:50 (f9be68accb407158ba2b1be2c226a6ce1f649314)
*/
/**
* This override provides extra, border layout specific methods for `Ext.Component`. The
* `Ext.layout.container.Border` class requires this override so that the added functions
* are only included in a build when `border` layout is used.
*/
Ext.define('Ext.layout.container.border.Region', {
override: 'Ext.Component',
/**
* This method is called by the `Ext.layout.container.Border` class when instances are
* added as regions to the layout. Since it is valid to add any component to a border
* layout as a region, this method must be added to `Ext.Component` but is only ever
* called when that component is owned by a `border` layout.
* @private
*/
initBorderRegion: function () {
var me = this;
if (!me._borderRegionInited) {
me._borderRegionInited = true;
// Now that border regions can have dynamic region/weight, these need to be
// saved to state as they change:
me.addStateEvents(['changeregion', 'changeweight']);
// We override getState on the instance for a couple reasons. Firstly, since
// there are very few border regions in an application, the overhead here is
// not a concern. Secondly, if this method were on the prototype it would
// impact all components.
Ext.override(me, {
getState: function () {
var state = me.callParent();
// Now that border regions can have dynamic region/weight, these need to be saved
// to state:
state = me.addPropertyToState(state, 'region');
state = me.addPropertyToState(state, 'weight');
return state;
}
});
}
},
/**
* Returns the owning container if that container uses `border` layout. Otherwise
* this method returns `null`.
* @return {Ext.container.Container} The owning border container or `null`.
* @private
*/
getOwningBorderContainer: function () {
var layout = this.getOwningBorderLayout();
return layout && layout.owner;
},
/**
* Returns the owning `border` (`Ext.layout.container.Border`) instance if there is
* one. Otherwise this method returns `null`.
* @return {Ext.layout.container.Border} The owning border layout or `null`.
* @private
*/
getOwningBorderLayout: function () {
// the ownerLayot (if set) may or may not be a border layout
var layout = this.ownerLayout;
return (layout && layout.isBorderLayout) ? layout : null;
},
/**
* This method changes the `region` config property for this border region. This is
* only valid if this component is in a `border` layout (`Ext.layout.container.Border`).
* @param {String} region The new `region` value (`"north"`, `"south"`, `"east"` or
* `"west"`).
* @return {String} The previous value of the `region` property.
*/
setBorderRegion: function (region) {
var me = this,
borderLayout,
old = me.region;
if (region !== old) {
borderLayout = me.getOwningBorderLayout();
if (borderLayout) {
var regionFlags = borderLayout.regionFlags[region],
placeholder = me.placeholder,
splitter = me.splitter,
owner = borderLayout.owner,
regionMeta = borderLayout.regionMeta,
collapsed = me.collapsed || me.floated,
delta, items, index;
if (me.fireEventArgs('beforechangeregion', [me, region]) === false) {
return old;
}
Ext.suspendLayouts();
me.region = region;
Ext.apply(me, regionFlags);
if (me.updateCollapseTool) {
me.updateCollapseTool();
}
if (splitter) {
// splitter.region = region; -- we don't set "region" on splitters!
Ext.apply(splitter, regionFlags);
splitter.updateOrientation();
items = owner.items;
index = items.indexOf(me);
if (index >= 0) {
delta = regionMeta[region].splitterDelta;
if (items.getAt(index + delta) !== splitter) {
// splitter is not where we expect it, so move it there
items.remove(splitter);
index = items.indexOf(me); // could have changed
if (delta > 0) {
++index;
}
// else, insert at index and splitter will be before the item
items.insert(index, splitter);
// Now that the splitter is in the right place in me.items,
// the layout will fix up the DOM childNode to be at the same
// index as well.
}
}
}
if (placeholder) {
// The collapsed item is potentially remembering wrong things (for
// example, if it was collapsed as a West region and changed to be
// North). The only simple answer here is to expand/collapse the
// item (w/o animation).
if (collapsed) {
me.expand(false);
}
owner.remove(placeholder);
me.placeholder = null; // force creation of a new placeholder
if (collapsed) {
me.collapse(null, false);
}
}
owner.updateLayout();
Ext.resumeLayouts(true);
me.fireEventArgs('changeregion', [me, old]);
} else {
me.region = region; // maybe not added yet
}
}
return old;
},
/**
* Sets the `weight` config property for this component. This is only valid if this
* component is in a `border` layout (`Ext.layout.container.Border`).
* @param {Number} weight The new `weight` value.
* @return {Number} The previous value of the `weight` property.
*/
setRegionWeight: function (weight) {
var me = this,
ownerCt = me.getOwningBorderContainer(),
placeholder = me.placeholder,
old = me.weight;
if (weight !== old) {
if (me.fireEventArgs('beforechangeweight', [me, weight]) !== false) {
me.weight = weight;
if (placeholder) {
placeholder.weight = weight;
}
if (ownerCt) {
ownerCt.updateLayout();
}
me.fireEventArgs('changeweight', [me, old]);
}
}
return old;
}
});
|
Download
