XRObservableCollection.ClearItemsImpl (Compact 7)
3/12/2014
This protected method implements collection operations for removing all items from the collection and invokes XRObservableCollection.OnCollectionChanged(XRCollectionChangedCustomEventArgs *) to send an event notification that the collection has changed.
Syntax
HRESULT STDMETHODCALLTYPE ClearItemsImpl(void)
Parameters
None
Return Value
The following table shows the possible return values.
Value | Description |
---|---|
S_OK |
The method was successful. |
E_BUSY |
The collection is currently being updated. |
Remarks
This method calls XRObservableCollection.OnCollectionChanged(XRCollectionChangedCustomEventArgs *) to raise the CollectionChanged event.
The inherited method _XRValueCollectionBaseT.Clear internally calls ClearItemsImpl to execute the functionality that clears all items in the collection. You can override the ClearItemsImpl method to provide a customized implementation that clears all items in the collection.
Because XRObservableCollection.ClearItemsImpl is a protected member, an instance of XRObservableCollection<ItemType> cannot directly access the XRObservableCollection.ClearItemsImpl method.
If you derive a new class from XRObservableCollection<ItemType> that uses either public
or protected
access modifiers, you can override this method in the new class.
Requirements
Header |
XRCollection.h |