getElementsByName method

  • Article

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

Gets a collection of objects based on the value of the NAME or ID attribute.

Document Object Model (DOM) Level 3 Core Specification, Section 1.4

Syntax

IHTMLElementCollection retVal = object.getElementsByName(v);

Standards information

Parameters

  • v [in]
    Type: BSTR

    A BSTR that specifies the value of a NAME attribute.

Remarks

When you use the getElementsByName method, all elements in the document that have the specified NAME attribute or ID attribute value are returned.

Elements that support both the NAME attribute and the ID attribute are included in the collection returned by the getElementsByName method, but elements with a NAME expando are not included in the collection; therefore, this method cannot be used to retrieve custom tags by name.

See also

About the W3C Document Object Model

 

 

Build date: 1/26/2012