Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Collapse the table of content
Expand the table of content

namedItem method

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


HRESULT retVal = object.namedItem(name, pdisp);


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


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

Standards information

There are no standards that apply here.


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.



Community Additions

© 2015 Microsoft