2005/5/9

     
 

class DOMImplementation

artefaktur
Modules   Namespace List   Class Hierarchy   Alphabetical List   Compound List   Namespace Members   Compound Members   Related Pages  

org::w3c::dom::DOMImplementation Class Reference

#include <DOMImplementation.h>

Inheritance diagram for org::w3c::dom::DOMImplementation:

acdk::xml::dom::XMLDocument acdk::xml::libxmldom::LibXMLDocumentBuilder List of all members.

Detailed Description

The DOMImplementation interface provides a number of methods for performing operations that are independent of any particular instance of the document object model.

See also the Document acdk::lang::Object Model (DOM) Level 3 Core Specification.

Author:
Roger Rene Kommer
Version:
Revision
1.13
Date:
Date
2005/02/05 10:45:37


Public Member Functions

virtual bool hasFeature (IN(RString) feature, IN(RString) version)=0
 Test if the DOM implementation implements a specific feature and version, as specified in .

virtual RDocument createDocument (IN(RString) namespaceURI, IN(RString) qualifiedName, IN(RDocumentType) doctype)=0
 Creates a DOM Document object of the specified type with its document element.


Member Function Documentation

virtual RDocument org::w3c::dom::DOMImplementation::createDocument IN(RString namespaceURI,
IN(RString qualifiedName,
IN(RDocumentType doctype
[pure virtual]
 

Creates a DOM Document object of the specified type with its document element.


Note that based on the DocumentType given to create the document, the implementation may instantiate specialized Document objects that support additional features than the Core, such as HTML [DOM Level 2 HTML] . On the other hand, setting the DocumentType after the document was created makes this very unlikely to happen. Alternatively, specialized Document creation methods, such as createHTMLDocument [DOM Level 2 HTML] , can be used to obtain specific types of Document objects.

Parameters:
namespaceURI The namespace URI of the document element to create or null.
qualifiedName The qualified name of the document element to be created or null.
doctype The type of document to be created or null. When doctype is not null, its Node.ownerDocument attribute is set to the document being created.
Returns:
A new Document object with its document element. If the NamespaceURI, qualifiedName, and doctype are null, the returned Document is empty with no document element.
Exceptions:
DOMException INVALID_CHARACTER_ERR: Raised if the specified qualified name is not an XML name according to [XML 1.0].
NAMESPACE_ERR: Raised if the qualifiedName is malformed, if the qualifiedName has a prefix and the namespaceURI is null, or if the qualifiedName is null and the namespaceURI is different from null, or if the qualifiedName has a prefix that is xml and the namespaceURI is different from http://www.w3.org/XML/1998/namespace [XML Namespaces] , or if the DOM implementation does not support the XML feature but a non-null namespace URI was provided, since namespaces were defined by XML.
WRONG_DOCUMENT_ERR: Raised if doctype has already been used with a different document or was created from a different implementation.
NOT_SUPPORTED_ERR: May be raised if the implementation does not support the feature XML and the language exposed through the Document does not support XML Namespaces (such as [HTML 4.01]).
Since:
DOM Level 2

Implemented in acdk::xml::dom::XMLDocument.

virtual bool org::w3c::dom::DOMImplementation::hasFeature IN(RString feature,
IN(RString version
[pure virtual]
 

Test if the DOM implementation implements a specific feature and version, as specified in .

Parameters:
feature The name of the feature to test.
version This is the version number of the feature to test.
Returns:
true if the feature is implemented in the specified version, false otherwise.

Implemented in acdk::xml::dom::XMLDocument, and acdk::xml::libxmldom::LibXMLDocumentBuilder.