From 1702a6daff27f5d3e6fdac16962d1828df6ca270 Mon Sep 17 00:00:00 2001 From: Michele Calgaro Date: Thu, 30 May 2024 12:36:05 +0900 Subject: Rename nt* dom and xml related files to equivalent tq* Signed-off-by: Michele Calgaro --- doc/html/qxmlcontenthandler.html | 266 --------------------------------------- 1 file changed, 266 deletions(-) delete mode 100644 doc/html/qxmlcontenthandler.html (limited to 'doc/html/qxmlcontenthandler.html') diff --git a/doc/html/qxmlcontenthandler.html b/doc/html/qxmlcontenthandler.html deleted file mode 100644 index 3aeec1313..000000000 --- a/doc/html/qxmlcontenthandler.html +++ /dev/null @@ -1,266 +0,0 @@ - - - - - -TQXmlContentHandler Class - - - - - - - -
- -Home - | -All Classes - | -Main Classes - | -Annotated - | -Grouped Classes - | -Functions -

TQXmlContentHandler Class Reference
[XML module]

- -

The TQXmlContentHandler class provides an interface to -report the logical content of XML data. -More... -

All the functions in this class are reentrant when TQt is built with thread support.

-

#include <ntqxml.h> -

Inherited by TQXmlDefaultHandler. -

List of all member functions. -

Public Members

- -

Detailed Description

- - - -The TQXmlContentHandler class provides an interface to -report the logical content of XML data. - -

- -

If the application needs to be informed of basic parsing events, -it can implement this interface and activate it using -TQXmlReader::setContentHandler(). The reader can then report basic -document-related events like the start and end of elements and -character data through this interface. -

The order of events in this interface is very important, and -mirrors the order of information in the document itself. For -example, all of an element's content (character data, processing -instructions, and sub-elements) appears, in order, between the -startElement() event and the corresponding endElement() event. -

The class TQXmlDefaultHandler provides a default implementation for -this interface; subclassing from the TQXmlDefaultHandler class is -very convenient if you only want to be informed of some parsing -events. -

The startDocument() function is called at the start of the -document, and endDocument() is called at the end. Before parsing -begins setDocumentLocator() is called. For each element -startElement() is called, with endElement() being called at the -end of each element. The characters() function is called with -chunks of character data; ignorableWhitespace() is called with -chunks of whitespace and processingInstruction() is called with -processing instructions. If an entity is skipped skippedEntity() -is called. At the beginning of prefix-URI scopes -startPrefixMapping() is called. -

See also the Introduction to SAX2. -

See also TQXmlDTDHandler, TQXmlDeclHandler, TQXmlEntityResolver, TQXmlErrorHandler, TQXmlLexicalHandler, and XML. - -

Member Function Documentation

-

bool TQXmlContentHandler::characters ( const TQString & ch ) [pure virtual] -

- -

The reader calls this function when it has parsed a chunk of -character data (either normal character data or character data -inside a CDATA section; if you need to distinguish between those -two types you must use TQXmlLexicalHandler::startCDATA() and -TQXmlLexicalHandler::endCDATA()). The character data is reported in -ch. -

Some readers report whitespace in element content using the -ignorableWhitespace() function rather than using this one. -

A reader may report the character data of an element in more than -one chunk; e.g. a reader might want to report "a<b" in three -characters() events ("a ", "<" and " b"). -

If this function returns FALSE the reader stops parsing and -reports an error. The reader uses the function errorString() to -get the error message. - -

bool TQXmlContentHandler::endDocument () [pure virtual] -

- -

The reader calls this function after it has finished parsing. It -is called just once, and is the last handler function called. It -is called after the reader has read all input or has abandoned -parsing because of a fatal error. -

If this function returns FALSE the reader stops parsing and -reports an error. The reader uses the function errorString() to -get the error message. -

See also startDocument(). - -

bool TQXmlContentHandler::endElement ( const TQString & namespaceURI, const TQString & localName, const TQString & qName ) [pure virtual] -

- -

The reader calls this function when it has parsed an end element -tag with the qualified name qName, the local name localName -and the namespace URI namespaceURI. -

If this function returns FALSE the reader stops parsing and -reports an error. The reader uses the function errorString() to -get the error message. -

See also the namespace description. -

See also startElement(). - -

Example: xml/tagreader/structureparser.cpp. -

bool TQXmlContentHandler::endPrefixMapping ( const TQString & prefix ) [pure virtual] -

- -

The reader calls this function to signal the end of a prefix -mapping for the prefix prefix. -

If this function returns FALSE the reader stops parsing and -reports an error. The reader uses the function errorString() to -get the error message. -

See also the namespace description. -

See also startPrefixMapping(). - -

TQString TQXmlContentHandler::errorString () [pure virtual] -

- -

The reader calls this function to get an error string, e.g. if any -of the handler functions returns FALSE. - -

bool TQXmlContentHandler::ignorableWhitespace ( const TQString & ch ) [pure virtual] -

- -

Some readers may use this function to report each chunk of -whitespace in element content. The whitespace is reported in ch. -

If this function returns FALSE the reader stops parsing and -reports an error. The reader uses the function errorString() to -get the error message. - -

bool TQXmlContentHandler::processingInstruction ( const TQString & target, const TQString & data ) [pure virtual] -

- -

The reader calls this function when it has parsed a processing -instruction. -

target is the target name of the processing instruction and data is the data in the processing instruction. -

If this function returns FALSE the reader stops parsing and -reports an error. The reader uses the function errorString() to -get the error message. - -

void TQXmlContentHandler::setDocumentLocator ( TQXmlLocator * locator ) [pure virtual] -

- -

The reader calls this function before it starts parsing the -document. The argument locator is a pointer to a TQXmlLocator -which allows the application to get the parsing position within -the document. -

Do not destroy the locator; it is destroyed when the reader is -destroyed. (Do not use the locator after the reader is -destroyed). - -

bool TQXmlContentHandler::skippedEntity ( const TQString & name ) [pure virtual] -

- -

Some readers may skip entities if they have not seen the -declarations (e.g. because they are in an external DTD). If they -do so they report that they skipped the entity called name by -calling this function. -

If this function returns FALSE the reader stops parsing and -reports an error. The reader uses the function errorString() to -get the error message. - -

bool TQXmlContentHandler::startDocument () [pure virtual] -

- -

The reader calls this function when it starts parsing the -document. The reader calls this function just once, after the call -to setDocumentLocator(), and before any other functions in this -class or in the TQXmlDTDHandler class are called. -

If this function returns FALSE the reader stops parsing and -reports an error. The reader uses the function errorString() to -get the error message. -

See also endDocument(). - -

Example: xml/tagreader/structureparser.cpp. -

bool TQXmlContentHandler::startElement ( const TQString & namespaceURI, const TQString & localName, const TQString & qName, const TQXmlAttributes & atts ) [pure virtual] -

- -

The reader calls this function when it has parsed a start element -tag. -

There is a corresponding endElement() call when the corresponding -end element tag is read. The startElement() and endElement() calls -are always nested correctly. Empty element tags (e.g. <x/>) -cause a startElement() call to be immediately followed by an -endElement() call. -

The attribute list provided only contains attributes with explicit -values. The attribute list contains attributes used for namespace -declaration (i.e. attributes starting with xmlns) only if the -namespace-prefix property of the reader is TRUE. -

The argument namespaceURI is the namespace URI, or -TQString::null if the element has no namespace URI or if no -namespace processing is done. localName is the local name -(without prefix), or TQString::null if no namespace processing is -done, qName is the qualified name (with prefix) and atts are -the attributes attached to the element. If there are no -attributes, atts is an empty attributes object. -

If this function returns FALSE the reader stops parsing and -reports an error. The reader uses the function errorString() to -get the error message. -

See also the namespace description. -

See also endElement(). - -

Example: xml/tagreader/structureparser.cpp. -

bool TQXmlContentHandler::startPrefixMapping ( const TQString & prefix, const TQString & uri ) [pure virtual] -

- -

The reader calls this function to signal the begin of a prefix-URI -namespace mapping scope. This information is not necessary for -normal namespace processing since the reader automatically -replaces prefixes for element and attribute names. -

Note that startPrefixMapping() and endPrefixMapping() calls are -not guaranteed to be properly nested relative to each other: all -startPrefixMapping() events occur before the corresponding -startElement() event, and all endPrefixMapping() events occur -after the corresponding endElement() event, but their order is not -otherwise guaranteed. -

The argument prefix is the namespace prefix being declared and -the argument uri is the namespace URI the prefix is mapped to. -

If this function returns FALSE the reader stops parsing and -reports an error. The reader uses the function errorString() to -get the error message. -

See also the namespace description. -

See also endPrefixMapping(). - - -

-This file is part of the TQt toolkit. -Copyright © 1995-2007 -Trolltech. All Rights Reserved.

- -
Copyright © 2007 -TrolltechTrademarks -
TQt 3.3.8
-
- -- cgit v1.2.3