IHTMLAreasCollection::item Method

Retrieves an object from an areas collection.

Syntax

HRESULT item(
    VARIANT name,
    VARIANT index,
    IDispatch **pdisp
);

Parameters

• name
  [in] 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 name or id properties are retrieved, and a collection is returned if more than one match is made.
• index
  [in] VARIANT of type VT_I4 that specifies the zero-based index of the object to retrieve when a collection is returned.
• pdisp
  [out, retval] The address of a pointer that receives an IDispatch interface for the object or collection if successful, or NULL otherwise.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

Windows Internet Explorer 8 and later. In IE8 Standards mode, the index parameter is not used. For more information, see Defining Document Compatibility.

Call QueryInterface on the IDispatch interface pointer retrieved to pdisp to obtain the correct interface for the object or collection.

This function returns S_OK even if the element is not found. You should check the value of the pdisp ( IDispatch) pointer returned by this call. If the value of the pointer is NULL, the element was not found and the call was not successful.