DataSourceCollection

DataSource個實例的集合。

new DataSourceCollection()

Members

(readonly) dataSourceAdded : Event

將數(shù)據(jù)源添加到集合時引發(fā)的事件。事件處理程序?qū)鬟f添加的數(shù)據(jù)源。

(readonly) dataSourceMoved : Event

當(dāng)數(shù)據(jù)源更改集合中的位置時引發(fā)的事件。事件處理程序?qū)鬟f所移動的數(shù)據(jù)源、移動后的新索引以及移動前的舊索引。

(readonly) dataSourceRemoved : Event

從集合中刪除數(shù)據(jù)源時引發(fā)的事件。事件處理程序?qū)鬟f已刪除的數(shù)據(jù)源。

(readonly) length : Number

獲取此集合中的數(shù)據(jù)源數(shù)。

Methods

add(dataSource) → {Promise.<DataSource>}

向集合中添加數(shù)據(jù)源。

Parameters:

dataSource ((DataSource | Promise.<DataSource>)) 數(shù)據(jù)源或?qū)σ砑拥郊现械臄?shù)據(jù)源的承諾。傳遞承諾時，在該承諾成功解決之前，數(shù)據(jù)源不會實際添加到集合中。

contains(dataSource) → {Boolean}

檢查集合是否包含給定的數(shù)據(jù)源。

Parameters:

dataSource (DataSource) 要檢查的數(shù)據(jù)源。

destroy()

銷毀此集合中所有數(shù)據(jù)源所保留的資源。顯式銷毀此對象允許確定地釋放WebGL資源，而不是依賴垃圾收集器。一旦銷毀此對象，就不應(yīng)使用它；調(diào)用除isDestroyed以外的任何函數(shù)都將導(dǎo)致DeveloperError異常。因此，將返回值（undefined）賦給對象，如示例中所述。

Example

dataSourceCollection = dataSourceCollection && dataSourceCollection.destroy();

Throws

DeveloperError : 此對象已被銷毀，即調(diào)用destroy（）。

See:

DataSourceCollection#isDestroyed

get(index) → {DataSource}

從集合中按索引獲取數(shù)據(jù)源。

Parameters:

index (Number) 要檢索的索引。

getByName(name) → {Array.<DataSource>}

從集合中按名稱獲取數(shù)據(jù)源。

Parameters:

name (String) 要檢索的名稱。

indexOf(dataSource) → {Number}

確定集合中給定數(shù)據(jù)源的索引。

Parameters:

dataSource (DataSource) 要查找的索引的數(shù)據(jù)源。

isDestroyed() → {Boolean}

如果此對象被破壞，則返回true；否則返回false。如果此對象已被破壞，則不應(yīng)使用它；調(diào)用除isDestroyed以外的任何函數(shù)將導(dǎo)致DeveloperError異常。

See:

DataSourceCollection#destroy

lower(dataSource)

在集合中將數(shù)據(jù)源降低一個位置。

Parameters:

dataSource (DataSource) 要移動的數(shù)據(jù)源。

Throws

DeveloperError : 數(shù)據(jù)源不在此集合中。
DeveloperError : 此對象已被銷毀，即調(diào)用destroy（）。

lowerToBottom(dataSource)

將數(shù)據(jù)源降低到集合的底部。

Parameters:

dataSource (DataSource) 要移動的數(shù)據(jù)源。

Throws

DeveloperError : 數(shù)據(jù)源不在此集合中。
DeveloperError : 此對象已被銷毀，即調(diào)用destroy（）。

raise(dataSource)

在集合中向上提升一個位置的數(shù)據(jù)源。

Parameters:

dataSource (DataSource) 要移動的數(shù)據(jù)源。

Throws

DeveloperError : 數(shù)據(jù)源不在此集合中。
DeveloperError : 此對象已被銷毀，即調(diào)用destroy（）。

raiseToTop(dataSource)

將數(shù)據(jù)源提升到集合的頂部。

Parameters:

dataSource (DataSource) 要移動的數(shù)據(jù)源。

Throws

DeveloperError : 數(shù)據(jù)源不在此集合中。
DeveloperError : 此對象已被銷毀，即調(diào)用destroy（）。

remove(dataSource, destroy) → {Boolean}

從該集合中刪除數(shù)據(jù)源（如果存在）。

Parameters:

dataSource (DataSource) 要刪除的數(shù)據(jù)源。

destroy (Boolean) (default false) 是否在刪除數(shù)據(jù)源的同時銷毀數(shù)據(jù)源。

removeAll(destroy)

從此集合中刪除所有數(shù)據(jù)源。

Parameters:

destroy (Boolean) (default false) 是否在刪除數(shù)據(jù)源的同時銷毀數(shù)據(jù)源。