item method

Retrieves an attribute for an element from an attributes collection.

 

Syntax

 retVal = object.item(name);

Parameters

• name [in]
  Type: VARIANT

  A pointer to a VARIANT of type VT_I4 or VT_BSTR that specifies the attribute. If this parameter is an integer, it is the zero-based index of the attribute to be retrieved from the attributes collection. If this parameter is a string, the attribute whose name matches the string is retrieved.

Standards information

• Document Object Model (DOM) Level 2 HTML Specification, Section 1.6.5

Remarks

Call QueryInterface on pdisp to obtain an IHTMLDOMAttribute interface pointer.

This method returns an error if the attribute is not found. When the IHTMLAttributeCollection::item method gets an attribute by name, name must match the case of the attribute.

Windows Internet Explorer 8 and later. In IE8 Standards mode, this method no longer indexes the attributes collection by the IHTMLDOMAttribute2::name property of the attribute object; it now accepts only numeric indexes or quoted numeric indexes. If given a string that is not a numeric index, this method will return the object at index 0. Use IHTMLAttributeCollection2::getNamedItem to reference an attribute by IHTMLDOMAttribute2::name. For more information, see Defining Document Compatibility.

Examples

This example uses the IHTMLAttributeCollection::item method to get the name and value of each attribute for an element, and whether the attribute has been specified.

IHTMLDOMNode* pElemDN;
IDispatch* pACDisp;
IHTMLAttributeCollection* pAttrColl;
IDispatch* pItemDisp;
IHTMLDOMAttribute* pItem;
LONG lACLength;
VARIANT vACIndex;
BSTR bstrName;
VARIANT vValue;
VARIANT_BOOL vbSpecified;
m_pElem->QueryInterface(IID_IHTMLDOMNode, (void**)&pElemDN);
pElemDN->get_attributes(&pACDisp);
pACDisp->QueryInterface(IID_IHTMLAttributeCollection, (void**)&pAttrColl);
pAttrColl->get_length(&lACLength);
vACIndex.vt = VT_I4;
for (int i = 0; i < lACLength; i++)
{
    vACIndex.lVal = i;
    pAttrColl->item(&vACIndex, &pItemDisp);
    pItemDisp->QueryInterface(IID_IHTMLDOMAttribute, (void**)&pItem);
    pItem->get_specified(&vbSpecified);
    pItem->get_nodeName(&bstrName);
    pItem->get_nodeValue(&vValue);
    pItemDisp->Release();
    pItem->Release();
}
pElemDN->Release();
pACDisp->Release();
pAttrColl->Release();