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