Export (0) Print
Expand All

namedItem method

[This documentation is preliminary and is subject to change.]

Retrieves a form object or an object from an elements collection.

Syntax


HRESULT retVal = object.namedItem(name, );

Standards information

There are no standards that apply here.

Parameters

name [in]

Type: BSTR

A BSTR that specifies the IHTMLDOMAttribute2::name or IHTMLElement::id property of the object to retrieve. A collection is returned if more than one match is made.

pdisp [out, retval]

Type: IDispatch

The address of a pointer to a variable that receives an IDispatch interface for the object or collection if successful, or NULL otherwise.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The IHTMLElementCollection3::namedItem method was introduced in Microsoft Internet Explorer 6

This method first searches for an object with a matching IHTMLElement::id attribute. If a match is not found, then the method searches for an object with a matching IHTMLDOMAttribute2::name attribute, but only on those elements that are allowed a name attribute.

 

 

Build date: 6/6/2012

Community Additions

Show:
© 2014 Microsoft