You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
qt3/doc/html/qdom-h.html

723 lines
23 KiB

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qdom.h:1 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>qdom.h Include File</title>
<style type="text/css"><!--
fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; }
--></style>
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr bgcolor="#E5E5E5">
<td valign=center>
<a href="index.html">
<font color="#004faf">Home</font></a>
| <a href="classes.html">
<font color="#004faf">All&nbsp;Classes</font></a>
| <a href="mainclasses.html">
<font color="#004faf">Main&nbsp;Classes</font></a>
| <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
| <a href="groups.html">
<font color="#004faf">Grouped&nbsp;Classes</font></a>
| <a href="functions.html">
<font color="#004faf">Functions</font></a>
</td>
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>qdom.h</h1>
<p>This is the verbatim text of the qdom.h include file. It is provided only for illustration; the copyright remains with Trolltech.
<hr>
<pre>
/****************************************************************************
** $Id: qt/qdom.h 3.3.8 edited Jan 11 14:39 $
**
** Definition of QDomDocument and related classes.
**
** Created : 000518
**
** Copyright (C) 1992-2007 Trolltech ASA. All rights reserved.
**
** This file is part of the xml module of the Qt GUI Toolkit.
**
** This file may be used under the terms of the GNU General Public
** License versions 2.0 or 3.0 as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL included in the
** packaging of this file. Alternatively you may (at your option) use any
** later version of the GNU General Public License if such license has
** been publicly approved by Trolltech ASA (or its successors, if any)
** and the KDE Free Qt Foundation.
**
** Please review the following information to ensure GNU General
** Public Licensing requirements will be met:
** http://trolltech.com/products/qt/licenses/licensing/opensource/.
** If you are unsure which license is appropriate for your use, please
** review the following information:
** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
** or contact the sales department at sales@trolltech.com.
**
** This file may be used under the terms of the Q Public License as
** defined by Trolltech ASA and appearing in the file LICENSE.QPL
** included in the packaging of this file. Licensees holding valid Qt
** Commercial licenses may use this file in accordance with the Qt
** Commercial License Agreement provided with the Software.
**
** This file is provided "AS IS" with NO WARRANTY OF ANY KIND,
** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted
** herein.
**
**********************************************************************/
#ifndef QDOM_H
#define QDOM_H
#ifndef QT_H
#include "qstring.h"
#endif // QT_H
#if !defined(QT_MODULE_XML) || defined( QT_LICENSE_PROFESSIONAL ) || defined( QT_INTERNAL_XML )
#define QM_EXPORT_DOM
#else
#define QM_EXPORT_DOM Q_EXPORT
#endif
#ifndef QT_NO_DOM
class QIODevice;
class QTextStream;
class QXmlInputSource;
class QXmlReader;
class QDomDocumentPrivate;
class QDomDocumentTypePrivate;
class QDomDocumentFragmentPrivate;
class QDomNodePrivate;
class QDomNodeListPrivate;
class QDomImplementationPrivate;
class QDomElementPrivate;
class QDomNotationPrivate;
class QDomEntityPrivate;
class QDomEntityReferencePrivate;
class QDomProcessingInstructionPrivate;
class QDomAttrPrivate;
class QDomCharacterDataPrivate;
class QDomTextPrivate;
class QDomCommentPrivate;
class QDomCDATASectionPrivate;
class QDomNamedNodeMapPrivate;
class QDomImplementationPrivate;
class QDomNodeList;
class QDomElement;
class QDomText;
class QDomComment;
class QDomCDATASection;
class QDomProcessingInstruction;
class QDomAttr;
class QDomEntityReference;
class QDomDocument;
class QDomNamedNodeMap;
class QDomDocument;
class QDomDocumentFragment;
class QDomDocumentType;
class QDomImplementation;
class QDomNode;
class QDomEntity;
class QDomNotation;
class QDomCharacterData;
class QM_EXPORT_DOM QDomImplementation
{
public:
QDomImplementation();
QDomImplementation( const QDomImplementation&amp; );
virtual ~QDomImplementation();
QDomImplementation&amp; operator= ( const QDomImplementation&amp; );
bool operator== ( const QDomImplementation&amp; ) const;
bool operator!= ( const QDomImplementation&amp; ) const;
// functions
virtual bool hasFeature( const QString&amp; feature, const QString&amp; version );
virtual QDomDocumentType createDocumentType( const QString&amp; qName, const QString&amp; publicId, const QString&amp; systemId );
virtual QDomDocument createDocument( const QString&amp; nsURI, const QString&amp; qName, const QDomDocumentType&amp; doctype );
// Qt extension
bool isNull();
private:
QDomImplementationPrivate* impl;
QDomImplementation( QDomImplementationPrivate* );
friend class QDomDocument;
};
class QM_EXPORT_DOM QDomNode
{
public:
enum NodeType {
ElementNode = 1,
AttributeNode = 2,
TextNode = 3,
CDATASectionNode = 4,
EntityReferenceNode = 5,
EntityNode = 6,
ProcessingInstructionNode = 7,
CommentNode = 8,
DocumentNode = 9,
DocumentTypeNode = 10,
DocumentFragmentNode = 11,
NotationNode = 12,
BaseNode = 21,// this is not in the standard
CharacterDataNode = 22 // this is not in the standard
};
QDomNode();
QDomNode( const QDomNode&amp; );
QDomNode&amp; operator= ( const QDomNode&amp; );
bool operator== ( const QDomNode&amp; ) const;
bool operator!= ( const QDomNode&amp; ) const;
virtual ~QDomNode();
// DOM functions
virtual QDomNode insertBefore( const QDomNode&amp; newChild, const QDomNode&amp; refChild );
virtual QDomNode insertAfter( const QDomNode&amp; newChild, const QDomNode&amp; refChild );
virtual QDomNode replaceChild( const QDomNode&amp; newChild, const QDomNode&amp; oldChild );
virtual QDomNode removeChild( const QDomNode&amp; oldChild );
virtual QDomNode appendChild( const QDomNode&amp; newChild );
virtual bool hasChildNodes() const;
virtual QDomNode cloneNode( bool deep = TRUE ) const;
virtual void normalize();
virtual bool isSupported( const QString&amp; feature, const QString&amp; version ) const;
// DOM read only attributes
virtual QString nodeName() const;
virtual QDomNode::NodeType nodeType() const;
virtual QDomNode parentNode() const;
virtual QDomNodeList childNodes() const;
virtual QDomNode firstChild() const;
virtual QDomNode lastChild() const;
virtual QDomNode previousSibling() const;
virtual QDomNode nextSibling() const;
virtual QDomNamedNodeMap attributes() const;
virtual QDomDocument ownerDocument() const;
virtual QString namespaceURI() const;
virtual QString localName() const;
virtual bool hasAttributes() const;
// DOM attributes
virtual QString nodeValue() const;
virtual void setNodeValue( const QString&amp; );
virtual QString prefix() const;
virtual void setPrefix( const QString&amp; pre );
// Qt extensions
virtual bool isAttr() const;
virtual bool isCDATASection() const;
virtual bool isDocumentFragment() const;
virtual bool isDocument() const;
virtual bool isDocumentType() const;
virtual bool isElement() const;
virtual bool isEntityReference() const;
virtual bool isText() const;
virtual bool isEntity() const;
virtual bool isNotation() const;
virtual bool isProcessingInstruction() const;
virtual bool isCharacterData() const;
virtual bool isComment() const;
/**
* Shortcut to avoid dealing with QDomNodeList
* all the time.
*/
QDomNode namedItem( const QString&amp; name ) const;
bool isNull() const;
void clear();
QDomAttr toAttr();
QDomCDATASection toCDATASection();
QDomDocumentFragment toDocumentFragment();
QDomDocument toDocument();
QDomDocumentType toDocumentType();
QDomElement toElement();
QDomEntityReference toEntityReference();
QDomText toText();
QDomEntity toEntity();
QDomNotation toNotation();
QDomProcessingInstruction toProcessingInstruction();
QDomCharacterData toCharacterData();
QDomComment toComment();
void save( QTextStream&amp;, int ) const;
protected:
QDomNodePrivate* impl;
QDomNode( QDomNodePrivate* );
private:
friend class QDomDocument;
friend class QDomDocumentType;
friend class QDomNodeList;
friend class QDomNamedNodeMap;
};
class QM_EXPORT_DOM QDomNodeList
{
public:
QDomNodeList();
QDomNodeList( const QDomNodeList&amp; );
QDomNodeList&amp; operator= ( const QDomNodeList&amp; );
bool operator== ( const QDomNodeList&amp; ) const;
bool operator!= ( const QDomNodeList&amp; ) const;
virtual ~QDomNodeList();
// DOM functions
virtual QDomNode item( int index ) const;
// DOM read only attributes
virtual uint length() const;
uint count() const { return length(); } // Qt API consitancy
private:
QDomNodeListPrivate* impl;
QDomNodeList( QDomNodeListPrivate* );
friend class QDomNode;
friend class QDomElement;
friend class QDomDocument;
};
class QM_EXPORT_DOM QDomDocumentType : public QDomNode
{
public:
QDomDocumentType();
QDomDocumentType( const QDomDocumentType&amp; x );
QDomDocumentType&amp; operator= ( const QDomDocumentType&amp; );
~QDomDocumentType();
// DOM read only attributes
virtual QString name() const;
virtual QDomNamedNodeMap entities() const;
virtual QDomNamedNodeMap notations() const;
virtual QString publicId() const;
virtual QString systemId() const;
virtual QString internalSubset() const;
// Reimplemented from QDomNode
QDomNode::NodeType nodeType() const;
bool isDocumentType() const;
private:
QDomDocumentType( QDomDocumentTypePrivate* );
friend class QDomImplementation;
friend class QDomDocument;
friend class QDomNode;
};
class QM_EXPORT_DOM QDomDocument : public QDomNode
{
public:
QDomDocument();
Q_EXPLICIT QDomDocument( const QString&amp; name );
Q_EXPLICIT QDomDocument( const QDomDocumentType&amp; doctype );
QDomDocument( const QDomDocument&amp; x );
QDomDocument&amp; operator= ( const QDomDocument&amp; );
~QDomDocument();
// DOM functions
QDomElement createElement( const QString&amp; tagName );
QDomDocumentFragment createDocumentFragment();
QDomText createTextNode( const QString&amp; data );
QDomComment createComment( const QString&amp; data );
QDomCDATASection createCDATASection( const QString&amp; data );
QDomProcessingInstruction createProcessingInstruction( const QString&amp; target, const QString&amp; data );
QDomAttr createAttribute( const QString&amp; name );
QDomEntityReference createEntityReference( const QString&amp; name );
QDomNodeList elementsByTagName( const QString&amp; tagname ) const;
QDomNode importNode( const QDomNode&amp; importedNode, bool deep );
QDomElement createElementNS( const QString&amp; nsURI, const QString&amp; qName );
QDomAttr createAttributeNS( const QString&amp; nsURI, const QString&amp; qName );
QDomNodeList elementsByTagNameNS( const QString&amp; nsURI, const QString&amp; localName );
QDomElement elementById( const QString&amp; elementId );
// DOM read only attributes
QDomDocumentType doctype() const;
QDomImplementation implementation() const;
QDomElement documentElement() const;
// Qt extensions
bool setContent( const QCString&amp; text, bool namespaceProcessing, QString *errorMsg=0, int *errorLine=0, int *errorColumn=0 );
bool setContent( const QByteArray&amp; text, bool namespaceProcessing, QString *errorMsg=0, int *errorLine=0, int *errorColumn=0 );
bool setContent( const QString&amp; text, bool namespaceProcessing, QString *errorMsg=0, int *errorLine=0, int *errorColumn=0 );
bool setContent( QIODevice* dev, bool namespaceProcessing, QString *errorMsg=0, int *errorLine=0, int *errorColumn=0 );
bool setContent( const QCString&amp; text, QString *errorMsg=0, int *errorLine=0, int *errorColumn=0 );
bool setContent( const QByteArray&amp; text, QString *errorMsg=0, int *errorLine=0, int *errorColumn=0 );
bool setContent( const QString&amp; text, QString *errorMsg=0, int *errorLine=0, int *errorColumn=0 );
bool setContent( QIODevice* dev, QString *errorMsg=0, int *errorLine=0, int *errorColumn=0 );
bool setContent( QXmlInputSource *source, QXmlReader *reader, QString *errorMsg=0, int *errorLine=0, int *errorColumn=0 );
// Reimplemented from QDomNode
QDomNode::NodeType nodeType() const;
bool isDocument() const;
// Qt extensions
QString toString() const; // ### Qt 4: merge the two overloads
QString toString( int ) const;
QCString toCString() const; // ### Qt 4: merge the two overloads
QCString toCString( int ) const;
private:
QDomDocument( QDomDocumentPrivate* );
friend class QDomNode;
};
class QM_EXPORT_DOM QDomNamedNodeMap
{
public:
QDomNamedNodeMap();
QDomNamedNodeMap( const QDomNamedNodeMap&amp; );
QDomNamedNodeMap&amp; operator= ( const QDomNamedNodeMap&amp; );
bool operator== ( const QDomNamedNodeMap&amp; ) const;
bool operator!= ( const QDomNamedNodeMap&amp; ) const;
~QDomNamedNodeMap();
// DOM functions
QDomNode namedItem( const QString&amp; name ) const;
QDomNode setNamedItem( const QDomNode&amp; newNode );
QDomNode removeNamedItem( const QString&amp; name );
QDomNode item( int index ) const;
QDomNode namedItemNS( const QString&amp; nsURI, const QString&amp; localName ) const;
QDomNode setNamedItemNS( const QDomNode&amp; newNode );
QDomNode removeNamedItemNS( const QString&amp; nsURI, const QString&amp; localName );
// DOM read only attributes
uint length() const;
uint count() const { return length(); } // Qt API consitancy
// Qt extension
bool contains( const QString&amp; name ) const;
private:
QDomNamedNodeMapPrivate* impl;
QDomNamedNodeMap( QDomNamedNodeMapPrivate* );
friend class QDomNode;
friend class QDomDocumentType;
friend class QDomElement;
};
class QM_EXPORT_DOM QDomDocumentFragment : public QDomNode
{
public:
QDomDocumentFragment();
QDomDocumentFragment( const QDomDocumentFragment&amp; x );
QDomDocumentFragment&amp; operator= ( const QDomDocumentFragment&amp; );
~QDomDocumentFragment();
// Reimplemented from QDomNode
QDomNode::NodeType nodeType() const;
bool isDocumentFragment() const;
private:
QDomDocumentFragment( QDomDocumentFragmentPrivate* );
friend class QDomDocument;
friend class QDomNode;
};
class QM_EXPORT_DOM QDomCharacterData : public QDomNode
{
public:
QDomCharacterData();
QDomCharacterData( const QDomCharacterData&amp; x );
QDomCharacterData&amp; operator= ( const QDomCharacterData&amp; );
~QDomCharacterData();
// DOM functions
virtual QString substringData( unsigned long offset, unsigned long count );
virtual void appendData( const QString&amp; arg );
virtual void insertData( unsigned long offset, const QString&amp; arg );
virtual void deleteData( unsigned long offset, unsigned long count );
virtual void replaceData( unsigned long offset, unsigned long count, const QString&amp; arg );
// DOM read only attributes
virtual uint length() const;
// DOM attributes
virtual QString data() const;
virtual void setData( const QString&amp; );
// Reimplemented from QDomNode
QDomNode::NodeType nodeType() const;
bool isCharacterData() const;
private:
QDomCharacterData( QDomCharacterDataPrivate* );
friend class QDomDocument;
friend class QDomText;
friend class QDomComment;
friend class QDomNode;
};
class QM_EXPORT_DOM QDomAttr : public QDomNode
{
public:
QDomAttr();
QDomAttr( const QDomAttr&amp; x );
QDomAttr&amp; operator= ( const QDomAttr&amp; );
~QDomAttr();
// DOM read only attributes
virtual QString name() const;
virtual bool specified() const;
virtual QDomElement ownerElement() const;
// DOM attributes
virtual QString value() const;
virtual void setValue( const QString&amp; );
// Reimplemented from QDomNode
QDomNode::NodeType nodeType() const;
bool isAttr() const;
private:
QDomAttr( QDomAttrPrivate* );
friend class QDomDocument;
friend class QDomElement;
friend class QDomNode;
};
class QM_EXPORT_DOM QDomElement : public QDomNode
{
public:
QDomElement();
QDomElement( const QDomElement&amp; x );
QDomElement&amp; operator= ( const QDomElement&amp; );
~QDomElement();
// DOM functions
QString attribute( const QString&amp; name, const QString&amp; defValue = QString::null ) const;
void setAttribute( const QString&amp; name, const QString&amp; value );
void setAttribute( const QString&amp; name, int value );
void setAttribute( const QString&amp; name, uint value );
void setAttribute( const QString&amp; name, long value );
void setAttribute( const QString&amp; name, ulong value );
void setAttribute( const QString&amp; name, double value );
void removeAttribute( const QString&amp; name );
QDomAttr attributeNode( const QString&amp; name);
QDomAttr setAttributeNode( const QDomAttr&amp; newAttr );
QDomAttr removeAttributeNode( const QDomAttr&amp; oldAttr );
virtual QDomNodeList elementsByTagName( const QString&amp; tagname ) const;
bool hasAttribute( const QString&amp; name ) const;
QString attributeNS( const QString nsURI, const QString&amp; localName, const QString&amp; defValue ) const;
void setAttributeNS( const QString nsURI, const QString&amp; qName, const QString&amp; value );
void setAttributeNS( const QString nsURI, const QString&amp; qName, int value );
void setAttributeNS( const QString nsURI, const QString&amp; qName, uint value );
void setAttributeNS( const QString nsURI, const QString&amp; qName, long value );
void setAttributeNS( const QString nsURI, const QString&amp; qName, ulong value );
void setAttributeNS( const QString nsURI, const QString&amp; qName, double value );
void removeAttributeNS( const QString&amp; nsURI, const QString&amp; localName );
QDomAttr attributeNodeNS( const QString&amp; nsURI, const QString&amp; localName );
QDomAttr setAttributeNodeNS( const QDomAttr&amp; newAttr );
virtual QDomNodeList elementsByTagNameNS( const QString&amp; nsURI, const QString&amp; localName ) const;
bool hasAttributeNS( const QString&amp; nsURI, const QString&amp; localName ) const;
// DOM read only attributes
QString tagName() const;
void setTagName( const QString&amp; name ); // Qt extension
// Reimplemented from QDomNode
QDomNamedNodeMap attributes() const;
QDomNode::NodeType nodeType() const;
bool isElement() const;
QString text() const;
private:
QDomElement( QDomElementPrivate* );
friend class QDomDocument;
friend class QDomNode;
friend class QDomAttr;
};
class QM_EXPORT_DOM QDomText : public QDomCharacterData
{
public:
QDomText();
QDomText( const QDomText&amp; x );
QDomText&amp; operator= ( const QDomText&amp; );
~QDomText();
// DOM functions
QDomText splitText( int offset );
// Reimplemented from QDomNode
QDomNode::NodeType nodeType() const;
bool isText() const;
private:
QDomText( QDomTextPrivate* );
friend class QDomCDATASection;
friend class QDomDocument;
friend class QDomNode;
};
class QM_EXPORT_DOM QDomComment : public QDomCharacterData
{
public:
QDomComment();
QDomComment( const QDomComment&amp; x );
QDomComment&amp; operator= ( const QDomComment&amp; );
~QDomComment();
// Reimplemented from QDomNode
QDomNode::NodeType nodeType() const;
bool isComment() const;
private:
QDomComment( QDomCommentPrivate* );
friend class QDomDocument;
friend class QDomNode;
};
class QM_EXPORT_DOM QDomCDATASection : public QDomText
{
public:
QDomCDATASection();
QDomCDATASection( const QDomCDATASection&amp; x );
QDomCDATASection&amp; operator= ( const QDomCDATASection&amp; );
~QDomCDATASection();
// Reimplemented from QDomNode
QDomNode::NodeType nodeType() const;
bool isCDATASection() const;
private:
QDomCDATASection( QDomCDATASectionPrivate* );
friend class QDomDocument;
friend class QDomNode;
};
class QM_EXPORT_DOM QDomNotation : public QDomNode
{
public:
QDomNotation();
QDomNotation( const QDomNotation&amp; x );
QDomNotation&amp; operator= ( const QDomNotation&amp; );
~QDomNotation();
// DOM read only attributes
QString publicId() const;
QString systemId() const;
// Reimplemented from QDomNode
QDomNode::NodeType nodeType() const;
bool isNotation() const;
private:
QDomNotation( QDomNotationPrivate* );
friend class QDomDocument;
friend class QDomNode;
};
class QM_EXPORT_DOM QDomEntity : public QDomNode
{
public:
QDomEntity();
QDomEntity( const QDomEntity&amp; x );
QDomEntity&amp; operator= ( const QDomEntity&amp; );
~QDomEntity();
// DOM read only attributes
virtual QString publicId() const;
virtual QString systemId() const;
virtual QString notationName() const;
// Reimplemented from QDomNode
QDomNode::NodeType nodeType() const;
bool isEntity() const;
private:
QDomEntity( QDomEntityPrivate* );
friend class QDomNode;
};
class QM_EXPORT_DOM QDomEntityReference : public QDomNode
{
public:
QDomEntityReference();
QDomEntityReference( const QDomEntityReference&amp; x );
QDomEntityReference&amp; operator= ( const QDomEntityReference&amp; );
~QDomEntityReference();
// Reimplemented from QDomNode
QDomNode::NodeType nodeType() const;
bool isEntityReference() const;
private:
QDomEntityReference( QDomEntityReferencePrivate* );
friend class QDomDocument;
friend class QDomNode;
};
class QM_EXPORT_DOM QDomProcessingInstruction : public QDomNode
{
public:
QDomProcessingInstruction();
QDomProcessingInstruction( const QDomProcessingInstruction&amp; x );
QDomProcessingInstruction&amp; operator= ( const QDomProcessingInstruction&amp; );
~QDomProcessingInstruction();
// DOM read only attributes
virtual QString target() const;
// DOM attributes
virtual QString data() const;
virtual void setData( const QString&amp; d );
// Reimplemented from QDomNode
QDomNode::NodeType nodeType() const;
bool isProcessingInstruction() const;
private:
QDomProcessingInstruction( QDomProcessingInstructionPrivate* );
friend class QDomDocument;
friend class QDomNode;
};
QM_EXPORT_DOM QTextStream&amp; operator&lt;&lt;( QTextStream&amp;, const QDomNode&amp; );
#endif //QT_NO_DOM
#endif // QDOM_H
</pre>
<!-- eof -->
<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright &copy; 2007
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
<td align=right><div align=right>Qt 3.3.8</div>
</table></div></address></body>
</html>