IXRItemCollection::Remove (Compact 2013)
3/28/2014
This method removes the last occurrence of a specific item from this collection.
Syntax
virtual HRESULT STDMETHODCALLTYPE Remove(
__in XRValue* pValue
) = 0;
Parameters
- pValue
[in] Pointer to an XRValue object that represents an item to remove from this collection.
Return Value
Returns S_OK if successful; otherwise, returns an HRESULT error code. For common error codes for XAML for Windows Embedded, see XAML for Windows Embedded Error Messages.
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 IXRItemCollection::GetCount.
If 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 at the first occurrence of the value. Therefore, if the collection contains the item more than once, the method removes the last occurrence of the item.
To use a specific interface pointer type, use the helper template version of this method that XAML for Windows Embedded provides. When you supply a derived type, this version automatically supplies a type-safe method that implicitly converts the returned type from a generic interface so you do not have to explicitly call QueryInterface to convert the generic interface into the required object type.
.NET Framework Equivalent
System.Windows.PresentationFrameworkCollection(T).Remove
Requirements
Header |
XamlRuntime.h |
sysgen |
SYSGEN_XAML_RUNTIME |