Share via


IXRCollection<In_T, Out_T>::Remove (Windows Embedded CE 6.0)

1/6/2010

This method removes the first occurrence of a specific item from this collection.

Syntax

 virtual HRESULT STDMETHODCALLTYPE   Remove(
    In_T pvalue
) = 0;

Parameters

  • pvalue
    [in] A value that represents an item to remove from this collection.

    In inherited classes, the type of this item corresponds to the specific collection type that inherits from this template class.

Return Value

Returns an HRESULT that indicates success or failure.

Remarks

This method performs a linear search through this collection. Therefore, the average execution time is proportional to the number of items in this collection. You can retrieve this number by calling IXRCollection<In_T, Out_T>::GetCount.

When the collection contains duplicate values at different indexes, this method searches the collection for each duplicate value in reverse order, starting at the last occurrence of the value, and ending with the first occurrence of the value.

Therefore, if this collection contains the item more than once, it will remove the last occurrence of the item.

.NET Framework Equivalent

System.Windows.PresentationFrameworkCollection(T).Remove

Requirements

Header XamlRuntime.h
sysgen SYSGEN_XAML_RUNTIME
Windows Embedded CE Windows Embedded CE 6.0 R3

See Also

Reference

IXRCollection<In_T, Out_T>