Members
(readonly) collectionChanged : Event
獲取在從集合中添加或刪除實體時觸發(fā)的事件。生成的事件是a
EntityCollection.collectionChangedEventCallback
。
(readonly) id : String
獲取此集合的全局唯一標(biāo)識符。
(readonly) owner : (DataSource|CompositeEntityCollection)
獲取此實體集合的所有者,即創(chuàng)建它的數(shù)據(jù)源或復(fù)合實體集合。
show : Boolean
獲取是否應(yīng)顯示此實體集合。如果為真,則僅當(dāng)每個實體自身的Show屬性也為真時才顯示該實體。
(readonly) values : Array.<Entity>
獲取集合中實體實例的數(shù)組。不應(yīng)直接修改此數(shù)組。
Methods
(static) collectionChangedEventCallback(collection, added, removed, changed)
由
EntityCollection#collectionChanged
生成的事件的簽名。
Parameters:
向集合中添加實體。
Parameters:
Throws
-
DeveloperError : 此集合中已存在
的實體。
計算集合中實體的最大可用性。如果集合包含無限可用數(shù)據(jù)和非無限數(shù)據(jù)的組合,則它將僅返回與非無限數(shù)據(jù)相關(guān)的間隔。如果所有數(shù)據(jù)都是無限的,則返回?zé)o限間隔。
如果提供的實體在此集合中,則返回true,否則返回false。
Parameters:
獲取具有指定ID的實體。
Parameters:
id
(String)
要檢索的實體的ID。
獲取具有指定ID的實體,或者創(chuàng)建該實體,如果該實體不存在,則將其添加到集合中。
Parameters:
id
(String)
要檢索或創(chuàng)建的實體的ID。
從集合中移除實體。
Parameters:
從集合中移除所有實體。
從集合中刪除具有提供的ID的實體。
Parameters:
id
(String)
要刪除的實體的ID。
添加或刪除項目時立即恢復(fù)引發(fā)
EntityCollection#collectionChanged
事件。當(dāng)事件被掛起時所做的任何修改都將在調(diào)用此函數(shù)時作為單個事件觸發(fā)。此函數(shù)是引用計數(shù)的,只要對EntityCollection#resumeEvents
有相應(yīng)的調(diào)用,就可以安全地多次調(diào)用。
Throws
-
DeveloperError : Suspendevents之前不能調(diào)用ResumeEvents。
防止
EntityCollection#collectionChanged
事件被引發(fā),直到對EntityCollection#resumeEvents
進(jìn)行相應(yīng)的調(diào)用,此時將引發(fā)涵蓋所有掛起操作的單個事件。這樣可以有效地添加和刪除許多項目。只要對EntityCollection#resumeEvents
有相應(yīng)的調(diào)用,就可以安全地多次調(diào)用此函數(shù)。