getAttributeNode method

Retrieves an IHTMLDOMAttribute2 interface referenced by the IHTMLDOMAttribute2::name property.

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

 

Syntax

Copy 

HRESULT retVal = object.getAttributeNode(bstrname, ppAttribute);

Parameters

bstrname [in]

Type: BSTR

BSTR that specifies the IHTMLDOMAttribute2::name property of the requested IHTMLDOMAttribute2 interface.
ppAttribute [out, retval]

Type: IHTMLDOMAttribute

Address of a pointer variable that receives an IHTMLDOMAttribute2 pointer.

Return value

Type: HRESULT

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

Standards information

Remarks

Windows Internet Explorer 8 or later. In IE8 Standards mode, IHTMLElement4::getAttributeNode correctly populates the IHTMLDOMAttribute2::value property of the returned attribute object regardless of whether the IHTMLDOMAttribute::specified property is set to VARIANT_TRUE or VARIANT_FALSE. For more information on IE8 mode, see Defining Document Compatibility.

Internet Explorer 8 or later. In IE8 mode, the IHTMLDOMAttribute2::value property is correctly reported as a canonical attribute name. For example, <input type="text" readonly> and <input type="text" readonly="readonly"> would both set the input text field to read-only. In IE8 mode, the value is evaluated as a canonical value, "readonly". In IE7 and earlier modes, it is evaluated as a Boolean value, VARIANT_TRUE.

IHTMLElement4::getAttributeNode was introduced in Microsoft Internet Explorer 6.

Examples

The following example uses IHTMLElement4::getAttributeNode to create an attribute object and populate its value property, which is then passed by reference to an output variable for assignment to the contents of a div element. Note how the call to IHTMLElement::setAttribute changes the IHTMLLinkElement4::href value for the content attribute but not for the DOM attribute.

C++
Copy 

<html>
<head>
  <meta http-equiv="X-UA-Compatible" content="IE=8">
  <title>Attribute Node Example</title>
  <base href="http://msdn.microsoft.com/">
  <script>
    function GetAttrNode(){
     //Retrieve an attribute node and a DOM attribute.
     var o = document.getElementById("msdn");
     var sDomAttr = o.href;
     
     o.setAttribute('href', 'en-us/ie/default.aspx');
     var sContentAttr = o.getAttributeNode("href");
     var sOutput = ("Content attribute node value: " + sContentAttr.value + 
              "<br/>DOM attribute value: " + sDomAttr);
              
     document.getElementById("output").innerHTML = sOutput;
    }
  </script>
</head>
<body>
   <a id="msdn" href="en-us/default.aspx">Microsoft Developer Network</a>
   <div id="output" onmouseover="GetAttrNode()">Point here to display attribute values.</div>
</body>
</html>

 

 

Show: