Share via


IXRUIElementCollection::Remove (Compact 2013)

3/28/2014

This method removes a specific item from the IXRUIElementCollection collection.

Syntax

virtual HRESULT STDMETHODCALLTYPE Remove(
    __in IXRUIElement* pObject
) = 0;

Parameters

  • pObject
    [in] Pointer to an IXRUIElement 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 IXRUIElementCollection::GetCount.

Generally, Remove deletes the last occurrence of an item. However, because an object cannot exist more than once in a visual tree, an item can occur only once in this object collection.

.NET Framework Equivalent

System.Windows.PresentationFrameworkCollection(T).Remove

Requirements

Header

XamlRuntime.h

sysgen

SYSGEN_XAML_RUNTIME

See Also

Reference

IXRUIElementCollection
IXRPanel::GetChildren