[This documentation is preliminary and is subject to change.]
Retrieves an object from a collection.
VARIANT retVal = object.item(pvarIndex);
There are no standards that apply here.
- pvarIndex [in]
Type: VARIANTPointer to a VARIANT of type VT_I4 or VT_BSTR that specifies the object or collection to retrieve. If this parameter is an integer, it is the zero-based index of the object. If this parameter is a string, all objects with matching IHTMLElement::id properties are retrieved, and a collection is returned if more than one match is made.
Windows Internet Explorer 7 and later. If given a string that is not a numeric index, this method throws an error if no IHTMLElement::id property with that string value is found.
Always check the IDispatch pointer returned by this call, even if the method returns S_OK. If the value of the pointer is NULL, the element was not found and the call was not successful.
Upon successful return, the pvarResult parameter contains an IDispatch interface pointer or an array of IDispatch interface pointers that can be queried for a specific interface, depending on the collection type.
Build date: 6/12/2012