Class Ext.TabPanelItem

Package:	Ext
Class:	TabPanelItem
Extends:	Observable
Defined In:	TabPanel.js

属性 - 方法 - 事件

公共属性

属性		定义对象
	bodyEl : Ext.Element	TabPanelItem
	The body element for this TabPanelItem	TabPanelItem
	closeText : String	TabPanelItem
	The text displayed in the tooltip for the close icon.	TabPanelItem
	id : String	TabPanelItem
	The id for this TabPanelItem	TabPanelItem
	tabPanel : Ext.TabPanel	TabPanelItem
	The TabPanel this TabPanelItem belongs to	TabPanelItem

公共方法

方法		定义对象
	activate() : void	TabPanelItem
	Activate this TabPanelItem - this does deactivate the currently active TabPanelItem.	TabPanelItem
	addEvents(`Object object`) : void	Observable
	将对象中没有的事件从给出的对象中复制过来。	Observable
	addListener(`String eventName`, `Function handler`, [`Object scope`], [`Object options`]) : void	Observable
	为该组件加入事件处理器函数	Observable
	disable() : void	TabPanelItem
	Disable this TabPanelItem - this call is ignore if this is the active TabPanelItem.	TabPanelItem
	enable() : void	TabPanelItem
	Enable this TabPanelItem if it was previously disabled.	TabPanelItem
	fireEvent(`String eventName`, `Object... args`) : Boolean	Observable
	触发指定的事件, 并将参数传入（至少要有事件名称）。	Observable
	getText() : String	TabPanelItem
	Returns the text for this tab	TabPanelItem
	getUpdateManager() : Ext.UpdateManager	TabPanelItem
	Get the Ext.UpdateManager for the body of this TabPanelItem. Enables you to perform Ajax updates.	TabPanelItem
	hasListener(`String eventName`) : Boolean	Observable
	检查该对象是否拥有指定事件的侦听器	Observable
	hide() : void	TabPanelItem
	Hide this TabPanelItem - if you don't activate another TabPanelItem this could look odd.	TabPanelItem
	isActive() : Boolean	TabPanelItem
	Returns true if this tab is the active tab	TabPanelItem
	isHidden() : Boolean	TabPanelItem
	Returns true if this tab is "hidden"	TabPanelItem
	on(`String eventName`, `Function handler`, [`Object options`]) : void	Observable
	为该组件加入事件处理器函数, addListener 的简写方式	Observable
	purgeListeners() : void	Observable
	从对象身上移除所有的侦听器	Observable
	refresh() : void	TabPanelItem
	Force a content refresh from the URL specified in the setUrl() method. Will fail silently if the setUrl method has no...	TabPanelItem
	removeListener(`String eventName`, `Function handler`, [`Object scope`]) : void	Observable
	移除侦听器	Observable
	setContent(`String content`, `Boolean loadScripts`) : void	TabPanelItem
	Set the content for this TabPanelItem.	TabPanelItem
	setText(`String text`) : void	TabPanelItem
	Sets the text for the tab (Note: this also sets the tooltip)	TabPanelItem
	setTooltip(`String tooltip`) : void	TabPanelItem
	Set the tooltip for the tab	TabPanelItem
	setUrl(`String/Function url`, [`String/Object params`], [`Boolean loadOnce`]) : Ext.UpdateManager	TabPanelItem
	Set a URL to be used to load the content for this TabPanelItem.	TabPanelItem
	show() : void	TabPanelItem
	Show this TabPanelItem - this does not deactivate the currently active TabPanelItem.	TabPanelItem
	un(`String eventName`, `Function handler`, [`Object scope`]) : void	Observable
	移除侦听器, removeListener 的简写方式	Observable

公共事件

事件		定义对象
	activate : (`Ext.TabPanel tabPanel`, `Ext.TabPanelItem this`)	TabPanelItem
	Fires when this tab becomes the active tab	TabPanelItem
	beforeclose : (`Ext.TabPanelItem this`, `Object e`)	TabPanelItem
	Fires before this tab is closed. To cancal the close, set cancel to true on e. (e.cancel = true)	TabPanelItem
	close : (`Ext.TabPanelItem this`)	TabPanelItem
	Fires when this tab is closed	TabPanelItem
	deactivate : (`Ext.TabPanel tabPanel`, `Ext.TabPanelItem this`)	TabPanelItem
	Fires when this tab is no longer the active tab	TabPanelItem

属性详情

bodyEl

public Ext.Element bodyEl

The body element for this TabPanelItem

This property is defined by TabPanelItem.

closeText

public String closeText

The text displayed in the tooltip for the close icon.

This property is defined by TabPanelItem.

id

public String id

The id for this TabPanelItem

This property is defined by TabPanelItem.

tabPanel

public Ext.TabPanel tabPanel

The TabPanel this TabPanelItem belongs to

This property is defined by TabPanelItem.

方法详情

activate

public function activate()

Activate this TabPanelItem - this does deactivate the currently active TabPanelItem.

参数：

无。

返回：

void

This method is defined by TabPanelItem.

addEvents

public function addEvents(Object object)

将对象中没有的事件从给出的对象中复制过来。给出的对象必须也继承于 Observable 对象此方法才会有效果。

参数：

object : Object
要复制事件的源对象

返回：

void

This method is defined by Observable.

addListener

public function addListener(String eventName, Function handler, [Object scope], [Object options])

为组件添加一个事件监听器

参数：

eventName : String
侦听事件的类型
handler : Function
事件调用的方法
scope : Object
（可选）处理函数执行的作用域。处理函数 "this" 的内容。
options : Object
（可选）一个包含处理设置属性的对象。可以包含下列的属性：
- scope {Object} 处理函数执行的作用域。处理函数 "this" 的内容。
- delegate {String} 一个简单的选择器用来过滤目标或查找目标的子节点。
- stopEvent {Boolean} 值为 True 时用来中止事件。那样将中止传播，并防止缺省动作。
- preventDefault {Boolean} 值为 True 时用来防止缺省动作。
- stopPropagation {Boolean} 值为 True 时用来中止事件传播。
- normalized {Boolean} 值为 False 时向处理函数传递浏览器事件用以代替 Ext.EventObject 对象。
- delay {Number} 当事件触发后启用处理函数的延迟微秒数。
- single {Boolean} 值为 True 时将添加一个处理函数用来处理下个触发的事件，并在处理完后移除。
- buffer {Number} 使处理函数计划在由 Ext.util.DelayedTask 指定的微秒数后执行。如果事件在延迟期间再次触发，原来的处理函数将不再启动，而是由新的计划代替。
组合选项
使用选项参数可以组合不同类型的监听器：

下面是一个标准的、延迟执行的、一次性的监听器，将会自动停止事件并传递一个自定义的参数(forumId)
代码：
```
el.on('click', this.onClick, this, { single: true, delay: 100, stopEvent : true, forumId: 4 });
```
这个方法也允许传递的单个参数是一个包含多个指定处理函数的设置对象。

一次调用多个处理函数
代码：
```
el.on({ 'click' : { fn: this.onClick scope: this, delay: 100 }, 'mouseover' : { fn: this.onMouseOver scope: this }, 'mouseout' : { fn: this.onMouseOut scope: this } });
```
或者简写为：
代码：
```
el.on({ 'click' : this.onClick, 'mouseover' : this.onMouseOver, 'mouseout' : this.onMouseOut scope: this });
```

返回：

void

This method is defined by Observable.

disable

public function disable()

Disable this TabPanelItem - this call is ignore if this is the active TabPanelItem.

参数：

无。

返回：

void

This method is defined by TabPanelItem.

enable

public function enable()

Enable this TabPanelItem if it was previously disabled.

参数：

无。

返回：

void

This method is defined by TabPanelItem.

fireEvent

public function fireEvent(String eventName, Object... args)

触发指定的事件并给出参数（至少要有事件名称）。

参数：

eventName : String
args : Object...
传入处理函数的参数

返回：

Boolean
如果任何处理函数返回 false 则返回值为 false, 否则返回 true。

This method is defined by Observable.

getText

public function getText()

Returns the text for this tab

参数：

无。

返回：

String

This method is defined by TabPanelItem.

getUpdateManager

public function getUpdateManager()

Get the Ext.UpdateManager for the body of this TabPanelItem. Enables you to perform Ajax updates.

参数：

无。

返回：

Ext.UpdateManager
The UpdateManager

This method is defined by TabPanelItem.

hasListener

public function hasListener(String eventName)

检查该对象是否拥有指定事件的侦听器

参数：

eventName : String
查询事件之名称

返回：

Boolean
值为 True 值表示事件监听器存在, 否则值为 false。

This method is defined by Observable.

hide

public function hide()

Hide this TabPanelItem - if you don't activate another TabPanelItem this could look odd.

参数：

无。

返回：

void

This method is defined by TabPanelItem.

isActive

public function isActive()

Returns true if this tab is the active tab

参数：

无。

返回：

Boolean

This method is defined by TabPanelItem.

isHidden

public function isHidden()

Returns true if this tab is "hidden"

参数：

无。

返回：

Boolean

This method is defined by TabPanelItem.

on

public function on(String eventName, Function handler, [Object options])

为该组件加入事件处理器函数, addListener 的简写方式

参数：

eventName : String
侦听事件的类型
handler : Function
事件调用的方法
options : Object
（可选）

返回：

void

This method is defined by Observable.

purgeListeners

public function purgeListeners()

从对象身上移除所有的侦听器

参数：

无。

返回：

void

This method is defined by Observable.

refresh

public function refresh()

Force a content refresh from the URL specified in the setUrl() method. Will fail silently if the setUrl method has not been called. This does not activate the panel, just updates its content.

参数：

无。

返回：

void

This method is defined by TabPanelItem.

removeListener

public function removeListener(String eventName, Function handler, [Object scope])

移除侦听器

参数：

eventName : String
侦听事件的类型
handler : Function
删除的处理函数
scope : Object
（可选） The scope (this object) for the handler

返回：

void

This method is defined by Observable.

setContent

public function setContent(String content, Boolean loadScripts)

Set the content for this TabPanelItem.

参数：

content : String
The content
loadScripts : Boolean
true to look for and load scripts

返回：

void

This method is defined by TabPanelItem.

setText

public function setText(String text)

Sets the text for the tab (Note: this also sets the tooltip)

参数：

text : String

返回：

void

This method is defined by TabPanelItem.

setTooltip

public function setTooltip(String tooltip)

Set the tooltip for the tab

参数：

tooltip : String

返回：

void

This method is defined by TabPanelItem.

setUrl

public function setUrl(String/Function url, [String/Object params], [Boolean loadOnce])

Set a URL to be used to load the content for this TabPanelItem.

参数：

url : String/Function
The url to load the content from or a function to call to get the url
params : String/Object
（可选） The string params for the update call or an object of the params. See Ext.UpdateManager.update for more details. (Defaults to null)
loadOnce : Boolean
（可选） Whether to only load the content once. If this is false it makes the Ajax call every time this TabPanelItem is activated. (Defaults to false)

返回：

Ext.UpdateManager
The UpdateManager

This method is defined by TabPanelItem.

show

public function show()

Show this TabPanelItem - this does not deactivate the currently active TabPanelItem.

参数：

无。

返回：

void

This method is defined by TabPanelItem.

un

public function un(String eventName, Function handler, [Object scope])

移除侦听器, removeListener 的简写方式

参数：

eventName : String
侦听事件的类型
handler : Function
删除的处理函数
scope : Object
（可选） The scope (this object) for the handler

返回：

void

This method is defined by Observable.

事件详情

activate

public event activate

Fires when this tab becomes the active tab

Subscribers will be called with the following parameters:

tabPanel : Ext.TabPanel
this : Ext.TabPanelItem

This event is defined by TabPanelItem.

beforeclose

public event beforeclose

Fires before this tab is closed. To cancal the close, set cancel to true on e. (e.cancel = true)

Subscribers will be called with the following parameters:

this : Ext.TabPanelItem
e : Object
Set cancel to true on this object to cancel the close.

This event is defined by TabPanelItem.

close

public event close

Fires when this tab is closed

Subscribers will be called with the following parameters:

this : Ext.TabPanelItem

This event is defined by TabPanelItem.

deactivate

public event deactivate

Fires when this tab is no longer the active tab

Subscribers will be called with the following parameters:

tabPanel : Ext.TabPanel
this : Ext.TabPanelItem

This event is defined by TabPanelItem.