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