QXmlDefaultHandler Class Reference · PyQt4 中文文檔

# QXmlDefaultHandler Class Reference ## [[QtXml](index.htm) module] 該QXmlDefaultHandler類提供了所有的XML處理程序類的默認實現。[More...](#details) 繼承[QXmlContentHandler](qxmlcontenthandler.html)，[QXmlErrorHandler](qxmlerrorhandler.html)，[QXmlDTDHandler](qxmldtdhandler.html)，[QXmlEntityResolver](qxmlentityresolver.html)，[QXmlLexicalHandler](qxmllexicalhandler.html)和[QXmlDeclHandler](qxmldeclhandler.html)。 ### Methods * `__init__ (self)` * `bool attributeDecl (self, QString?eName, QString?aName, QString?type, QString?valueDefault, QString?value)` * `bool characters (self, QString?ch)` * `bool comment (self, QString?ch)` * `bool endCDATA (self)` * `bool endDocument (self)` * `bool endDTD (self)` * `bool endElement (self, QString?namespaceURI, QString?localName, QString?qName)` * `bool endEntity (self, QString?name)` * `bool endPrefixMapping (self, QString?prefix)` * `bool error (self, QXmlParseException?exception)` * `QString errorString (self)` * `bool externalEntityDecl (self, QString?name, QString?publicId, QString?systemId)` * `bool fatalError (self, QXmlParseException?exception)` * `bool ignorableWhitespace (self, QString?ch)` * `bool internalEntityDecl (self, QString?name, QString?value)` * `bool notationDecl (self, QString?name, QString?publicId, QString?systemId)` * `bool processingInstruction (self, QString?target, QString?data)` * `(bool, QXmlInputSource?ret) resolveEntity (self, QString?publicId, QString?systemId)` * `setDocumentLocator (self, QXmlLocator?locator)` * `bool skippedEntity (self, QString?name)` * `bool startCDATA (self)` * `bool startDocument (self)` * `bool startDTD (self, QString?name, QString?publicId, QString?systemId)` * `bool startElement (self, QString?namespaceURI, QString?localName, QString?qName, QXmlAttributes?atts)` * `bool startEntity (self, QString?name)` * `bool startPrefixMapping (self, QString?prefix, QString?uri)` * `bool unparsedEntityDecl (self, QString?name, QString?publicId, QString?systemId, QString?notationName)` * `bool warning (self, QXmlParseException?exception)` * * * ## Detailed Description 該QXmlDefaultHandler類提供了所有的XML處理程序類的默認實現。這個類聚攏專門的處理程序類的功能，實現自定義處理程序的子類時，使其成為一個方便的起點[QXmlReader](qxmlreader.html)，特別是[QXmlSimpleReader](qxmlsimplereader.html)。從每一個基類的虛函數重新實現這個類，對于很多常見情況提供合理的默認行為。通過繼承這個類，并重寫這些功能，你可以專注于實現應用程序相關的處理程序的各個部分。 XML讀取器必須被告知在分析過程中使用的不同種類的事件的處理程序。這意味著，雖然QXmlDefaultHandler提供的所有基類繼承的函數的默認實現，我們仍然可以使用專門的處理程序為特定類型的事件。例如， QXmlDefaultHandler兩個子類[QXmlContentHandler](qxmlcontenthandler.html)和[QXmlErrorHandler](qxmlerrorhandler.html)，所以通過繼承它，我們可以使用相同的處理器為以下兩個讀卡器功能： ``` xmlReader.setContentHandler(handler); xmlReader.setErrorHandler(handler); ``` 由于閱讀器將通知解析錯誤的處理程序中，有必要重新實現[QXmlErrorHandler.fatalError](qxmlerrorhandler.html#fatalError)（）如果，例如，我們想停止這樣的時候發生錯誤解析： ``` bool Handler.fatalError (const [QXmlParseException](qxmlparseexception.html) & exception) { qWarning() << "Fatal error on line" << exception.lineNumber() << ", column" << exception.columnNumber() << ":" << exception.message(); return false; } ``` 上面的函數返回False ，它告訴讀者停止解析。繼續使用相同的閱讀器，就必須建立新的處理程序實例，并且設置了閱讀器把它用在上面描述的方式。重要的是要研究一些繼承QXmlDefaultHandler的功能，并考慮他們為什么會在自定義處理程序來重新實現是非常有用的。自定義處理程序通常會重新實現[QXmlContentHandler.startDocument](qxmlcontenthandler.html#startDocument)（）準備處理程序的新內容。文檔中的元素和其中的文本可以通過重新實現處理[QXmlContentHandler.startElement](qxmlcontenthandler.html#startElement)（）[QXmlContentHandler.endElement](qxmlcontenthandler.html#endElement)（）和[QXmlContentHandler.characters](qxmlcontenthandler.html#characters)（）。您可能需要重新實現[QXmlContentHandler.endDocument](qxmlcontenthandler.html#endDocument)（）來對內容進行一些最后確定或驗證，一旦該文件已被完全讀取。 * * * ## Method Documentation ``` QXmlDefaultHandler.__init__ (self) ``` 構造一個處理程序與子類使用[QXmlReader](qxmlreader.html)。 ``` bool QXmlDefaultHandler.attributeDecl (self, QString?eName, QString?aName, QString?type, QString?valueDefault, QString?value) ``` 從重新實現[QXmlDeclHandler.attributeDecl](qxmldeclhandler.html#attributeDecl)（）。這個重新實現不執行任何操作。 ``` bool QXmlDefaultHandler.characters (self, QString?ch) ``` 從重新實現[QXmlContentHandler.characters](qxmlcontenthandler.html#characters)（）。這個重新實現不執行任何操作。 ``` bool QXmlDefaultHandler.comment (self, QString?ch) ``` 從重新實現[QXmlLexicalHandler.comment](qxmllexicalhandler.html#comment)（）。這個重新實現不執行任何操作。 ``` bool QXmlDefaultHandler.endCDATA (self) ``` 從重新實現[QXmlLexicalHandler.endCDATA](qxmllexicalhandler.html#endCDATA)（）。這個重新實現不執行任何操作。 ``` bool QXmlDefaultHandler.endDocument (self) ``` 從重新實現[QXmlContentHandler.endDocument](qxmlcontenthandler.html#endDocument)（）。這個重新實現不執行任何操作。 ``` bool QXmlDefaultHandler.endDTD (self) ``` 從重新實現[QXmlLexicalHandler.endDTD](qxmllexicalhandler.html#endDTD)（）。這個重新實現不執行任何操作。 ``` bool QXmlDefaultHandler.endElement (self, QString?namespaceURI, QString?localName, QString?qName) ``` 從重新實現[QXmlContentHandler.endElement](qxmlcontenthandler.html#endElement)（）。這個重新實現不執行任何操作。 ``` bool QXmlDefaultHandler.endEntity (self, QString?name) ``` 從重新實現[QXmlLexicalHandler.endEntity](qxmllexicalhandler.html#endEntity)（）。這個重新實現不執行任何操作。 ``` bool QXmlDefaultHandler.endPrefixMapping (self, QString?prefix) ``` 從重新實現[QXmlContentHandler.endPrefixMapping](qxmlcontenthandler.html#endPrefixMapping)（）。這個重新實現不執行任何操作。 ``` bool QXmlDefaultHandler.error (self, QXmlParseException?exception) ``` 從重新實現[QXmlErrorHandler.error](qxmlerrorhandler.html#error)（）。這個重新實現不執行任何操作。 ``` QString QXmlDefaultHandler.errorString (self) ``` 從重新實現[QXmlContentHandler.errorString](qxmlcontenthandler.html#errorString)（）。返回默認的錯誤字符串。 ``` bool QXmlDefaultHandler.externalEntityDecl (self, QString?name, QString?publicId, QString?systemId) ``` 從重新實現[QXmlDeclHandler.externalEntityDecl](qxmldeclhandler.html#externalEntityDecl)（）。這個重新實現不執行任何操作。 ``` bool QXmlDefaultHandler.fatalError (self, QXmlParseException?exception) ``` 從重新實現[QXmlErrorHandler.fatalError](qxmlerrorhandler.html#fatalError)（）。這個重新實現不執行任何操作。 ``` bool QXmlDefaultHandler.ignorableWhitespace (self, QString?ch) ``` 從重新實現[QXmlContentHandler.ignorableWhitespace](qxmlcontenthandler.html#ignorableWhitespace)（）。這個重新實現不執行任何操作。 ``` bool QXmlDefaultHandler.internalEntityDecl (self, QString?name, QString?value) ``` 從重新實現[QXmlDeclHandler.internalEntityDecl](qxmldeclhandler.html#internalEntityDecl)（）。這個重新實現不執行任何操作。 ``` bool QXmlDefaultHandler.notationDecl (self, QString?name, QString?publicId, QString?systemId) ``` 從重新實現[QXmlDTDHandler.notationDecl](qxmldtdhandler.html#notationDecl)（）。這個重新實現不執行任何操作。 ``` bool QXmlDefaultHandler.processingInstruction (self, QString?target, QString?data) ``` 從重新實現[QXmlContentHandler.processingInstruction](qxmlcontenthandler.html#processingInstruction)（）。這個重新實現不執行任何操作。 ``` (bool, QXmlInputSource?ret) QXmlDefaultHandler.resolveEntity (self, QString?publicId, QString?systemId) ``` 從重新實現[QXmlEntityResolver.resolveEntity](qxmlentityresolver.html#resolveEntity)（）。 Sets _ret_為0，從而使讀取器使用的XML文件中提供的系統標識符。 ``` QXmlDefaultHandler.setDocumentLocator (self, QXmlLocator?locator) ``` 從重新實現[QXmlContentHandler.setDocumentLocator](qxmlcontenthandler.html#setDocumentLocator)（）。這個重新實現不執行任何操作。 ``` bool QXmlDefaultHandler.skippedEntity (self, QString?name) ``` 從重新實現[QXmlContentHandler.skippedEntity](qxmlcontenthandler.html#skippedEntity)（）。這個重新實現不執行任何操作。 ``` bool QXmlDefaultHandler.startCDATA (self) ``` 從重新實現[QXmlLexicalHandler.startCDATA](qxmllexicalhandler.html#startCDATA)（）。這個重新實現不執行任何操作。 ``` bool QXmlDefaultHandler.startDocument (self) ``` 從重新實現[QXmlContentHandler.startDocument](qxmlcontenthandler.html#startDocument)（）。這個重新實現不執行任何操作。 ``` bool QXmlDefaultHandler.startDTD (self, QString?name, QString?publicId, QString?systemId) ``` 從重新實現[QXmlLexicalHandler.startDTD](qxmllexicalhandler.html#startDTD)（）。這個重新實現不執行任何操作。 ``` bool QXmlDefaultHandler.startElement (self, QString?namespaceURI, QString?localName, QString?qName, QXmlAttributes?atts) ``` 從重新實現[QXmlContentHandler.startElement](qxmlcontenthandler.html#startElement)（）。這個重新實現不執行任何操作。 ``` bool QXmlDefaultHandler.startEntity (self, QString?name) ``` 從重新實現[QXmlLexicalHandler.startEntity](qxmllexicalhandler.html#startEntity)（）。這個重新實現不執行任何操作。 ``` bool QXmlDefaultHandler.startPrefixMapping (self, QString?prefix, QString?uri) ``` 從重新實現[QXmlContentHandler.startPrefixMapping](qxmlcontenthandler.html#startPrefixMapping)（）。這個重新實現不執行任何操作。 ``` bool QXmlDefaultHandler.unparsedEntityDecl (self, QString?name, QString?publicId, QString?systemId, QString?notationName) ``` 從重新實現[QXmlDTDHandler.unparsedEntityDecl](qxmldtdhandler.html#unparsedEntityDecl)（）。這個重新實現不執行任何操作。 ``` bool QXmlDefaultHandler.warning (self, QXmlParseException?exception) ``` 從重新實現[QXmlErrorHandler.warning](qxmlerrorhandler.html#warning)（）。這個重新實現不執行任何操作。