<?xml version="1.0" encoding="utf-8"?>

<!DOCTYPE apiClassifier PUBLIC "-//IBM//DTD DITA API Classifier Reference Type//EN"

 "../dtd/apiClassifier.dtd">

<apiClassifier id="MultiLanguage">

<apiName>Document interface</apiName>

<shortdesc>Represents the entire HTML or XML document. Conceptually, it is

the root of the document tree, and provides the primary access to the document's

data.</shortdesc>

<apiClassifierDetail>

<apiDesc>Since elements, text nodes, comments, processing instructions, etc.

cannot exist outside the context of a Document, the Document interface also

contains the factory methods needed to create these objects. The Node objects

created have a ownerDocument attribute which associates them with the Document

within whose context they were created.</apiDesc>

<example><pre platform="java">Document doc = docBuilder.newDocument();

Attr attr = doc.createAttribute("name");</pre><pre platform="vb">Dim xmlDoc As New Msxml2.DOMDocument30

Dim newAtt As IXMLDOMAttribute

Set newAtt = xmlDoc.createAttribute("name")</pre><p>The example creates a

document object and attribute object.</p></example>

</apiClassifierDetail>

<apiOperation id="createAttribute">

<apiName>createAttribute() method</apiName>

<shortdesc>Creates an Attr of the given name. </shortdesc>

<apiOperationDetail>

<apiSyntax platform="java">

<apiSyntaxText><apiItemName>Attr</apiItemName> createAttribute(String <apiItemName>name</apiItemName>) throws <apiRelation

keyref="org.w3c.dom.DOMException">DOMException</apiRelation></apiSyntaxText>

<apiSyntaxItem>

<apiItemName>Attr</apiItemName>

<apiDefNote id="attributeParamDesc">The returned <apiclassifier keyref="org.w3c.dom.Attr">Attr</apiclassifier> object.</apiDefNote>

</apiSyntaxItem>

<apiSyntaxItem id="nameParam">

<apiItemName>name</apiItemName>

<apiDefNote>The name for the created attribute.</apiDefNote>

</apiSyntaxItem>

</apiSyntax>

<apiSyntax platform="vb">

<apiSyntaxText>Sub createAttribute(<apiItemName>name</apiItemName>, <apiItemName>mode</apiItemName>) Returns <apiItemName>IXMLDOMAttribute</apiItemName

></apiSyntaxText>

<apiSyntaxItem conref="#createAttribute/nameParam"></apiSyntaxItem>

<apiSyntaxItem>

<apiItemName>mode</apiItemName>

<apiDefNote>The read / write mode for the created attribute.</apiDefNote>

</apiSyntaxItem>

<apiSyntaxItem>

<apiItemName>IXMLDOMAttribute</apiItemName>

<apiDefNote conref="#createAttribute/attributeParamDesc"></apiDefNote>

</apiSyntaxItem>

</apiSyntax>

<apiDesc>After creation, the <apiclassifier keyref="org.w3c.dom.Attr">Attr</apiclassifier> instance

can be set on an <apiclassifier keyref="org.w3c.dom.Element">Element</apiclassifier> instance

using the <apioperation keyref="org.w3c.dom.Element.setAttributeNode">setAttributeNode</apioperation> method.</apiDesc>

</apiOperationDetail>

</apiOperation>

</apiClassifier>