Share via


IXRItemCollection::Insert (Compact 2013)

3/28/2014

This method inserts an item into this collection at the location that has the specified index value.

Syntax

virtual HRESULT STDMETHODCALLTYPE Insert(
    __in int Index,
    __in XRValue* pValue
) = 0;

Parameters

  • Index
    [in] Integer value that indicates the zero-based index value at which pValue will be inserted.
  • pValue
    [in] Pointer to the XRValue object that represents the item to insert.

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

If Index is equal to the value that IXRItemCollection::GetCount retrieves, the item is added to the end of this collection.

When an item is inserted in this collection, the subsequent items are moved to the next indexed position.

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).IList.Insert

Requirements

Header

XamlRuntime.h

sysgen

SYSGEN_XAML_RUNTIME

See Also

Reference

IXRItemCollection
IXRItemsControl::GetItems