Click to return to the Reusing Browser Technology home page    
IHTMLFramesCollection2::g...     IHTMLFrameSetElement Inte...     IHTMLFramesCollection2 In...    
Web Workshop  |  Reusing Browser Technology

IHTMLFramesCollection2::item Method


Retrieves an element or a collection from the frames collection.

Syntax

HRESULT item(
    VARIANT *pvarIndex,
    VARIANT *pvarResult
);

Parameters

pvarIndex
Address of a VARIANT structure that specifies the element or collection to retrieve. If this parameter is a number, the method returns the element in the collection at the given position, where the first element has value 0, the second has 1, and so on. If this parameter is a string, the method returns a collection of elements, where the value of the name or id property for each element is equal to the string.
pvarResult
Address of a VARIANT structure that receives an element object or a collection of element objects if successful, or NULL otherwise.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

The pvarIndex parameter determines which action to take. This function returns an S_OK even if the element is not found. The developer should check the value of the pvarResult pointer returned by this call. If the value of the pointer is NULL, the element was not found and the call was not successful.

Windows CE

Windows CE Use version 2.12 and later
Minimum availability Internet Explorer 4.0


Back to topBack to top

Did you find this topic useful? Suggestions for other topics? Write us!

© 1999 Microsoft Corporation. All rights reserved. Terms of use.