Inserts a new item into a list at a specified position.
HRESULT insertItemBefore( ISVGTransform *newItem, long index, ISVGTransform **ppResult );
- [in] The item to insert into the list.
- [in] The index of the item that the newItem item is inserted before. The first item is number 0. If index equals 0, the new item is inserted at the front of the list. If the index is greater than or equal to ISVGPathSegList::numberOfItems, the new item is appended to the end of the list.
- [out, retval] The inserted item. This item is the item itself and not a copy.
Returns one of the following values.
S_OK The operation completed successfully. W3CException_DOM_NO_MODIFICATION_ALLOWED_ERR An attempt is made to modify an object that cannot be changed.
If the newItem item is already in a list, the ISVGPathSegList::insertItemBefore method removes it from its previous list before it is inserted into this list.