# QXmlContentHandler Class Reference ## [[QtXml](index.htm) module] 該QXmlContentHandler類提供了一個接口來報告XML數據的邏輯內容。[More...](#details) 通過繼承[QXmlDefaultHandler](qxmldefaulthandler.html)。 ### Methods * `__init__ (self)` * `__init__ (self, QXmlContentHandler)` * `bool characters (self, QString?ch)` * `bool endDocument (self)` * `bool endElement (self, QString?namespaceURI, QString?localName, QString?qName)` * `bool endPrefixMapping (self, QString?prefix)` * `QString errorString (self)` * `bool ignorableWhitespace (self, QString?ch)` * `bool processingInstruction (self, QString?target, QString?data)` * `setDocumentLocator (self, QXmlLocator?locator)` * `bool skippedEntity (self, QString?name)` * `bool startDocument (self)` * `bool startElement (self, QString?namespaceURI, QString?localName, QString?qName, QXmlAttributes?atts)` * `bool startPrefixMapping (self, QString?prefix, QString?uri)` * * * ## Detailed Description 該QXmlContentHandler類提供了一個接口來報告XML數據的邏輯內容。 如果應用程序需要被告知基本解析事件，它可以實現此接口，并使用激活[QXmlReader.setContentHandler](qxmlreader.html#setContentHandler)（ ） 。然后，讀者可以像報告通過此接口的開始和元素和字符數據的結束基本文檔相關的事件。 在此界面中事件的順序是非常重要的，反映的信息的順序在文檔本身中。例如，所有的元素的內容（字符數據，處理指令，以及子元素）時，按順序之間的[startElement](qxmlcontenthandler.html#startElement)（）事件和相應的[endElement](qxmlcontenthandler.html#endElement)（）事件。 類[QXmlDefaultHandler](qxmldefaulthandler.html)提供了該接口的默認實現，從子類[QXmlDefaultHandler](qxmldefaulthandler.html)類是非常方便的，如果你只想要獲知一些解析事件。 該[startDocument](qxmlcontenthandler.html#startDocument)（ ）函數被調用的文件的開始，并[endDocument](qxmlcontenthandler.html#endDocument)（）被調用時結束。解析開始之前[setDocumentLocator](qxmlcontenthandler.html#setDocumentLocator)（）被調用。對于每個元素[startElement](qxmlcontenthandler.html#startElement)（）被調用，以[endElement](qxmlcontenthandler.html#endElement)（）被調用時各元件的端部。該[characters](qxmlcontenthandler.html#characters)（ ）函數被調用字符的數據塊;[ignorableWhitespace](qxmlcontenthandler.html#ignorableWhitespace)（ ）被調用的空白塊，[processingInstruction](qxmlcontenthandler.html#processingInstruction)（ ）被調用，處理指令。如果一個實體被跳過[skippedEntity](qxmlcontenthandler.html#skippedEntity)（）被調用。在前綴的URI范圍的開始[startPrefixMapping](qxmlcontenthandler.html#startPrefixMapping)（）被調用。 * * * ## Method Documentation ``` QXmlContentHandler.__init__ (self) ``` ``` QXmlContentHandler.__init__ (self, QXmlContentHandler) ``` ``` bool QXmlContentHandler.characters (self, QString?ch) ``` 這種方法是抽象的，應在任何子類中重新實現。 讀者調用該函數時，它已經被解析的字符數據塊（在CDATA節無論是正常的字符數據或字符數據，如果您需要這兩種類型之間的區別，您必須使用[QXmlLexicalHandler.startCDATA](qxmllexicalhandler.html#startCDATA)（）和[QXmlLexicalHandler.endCDATA](qxmllexicalhandler.html#endCDATA)（））。字符數據中報告_ch_。 有些讀者使用空白報告元素內容中的[ignorableWhitespace](qxmlcontenthandler.html#ignorableWhitespace)（ ）函數，而不是使用這一個。 讀者可能會報告在一個以上的塊元素的字符數據，如讀者可能想報導“ A \u003cB ”的三個字符（ ）事件（ “A” ， “ \u003c ”和“b” ） 。 如果這個函數返回False讀者停止解析和報告錯誤。讀者使用函數[errorString](qxmlcontenthandler.html#errorString)（ ）來獲得錯誤信息。 ``` bool QXmlContentHandler.endDocument (self) ``` 這種方法是抽象的，應在任何子類中重新實現。 讀者調用該函數后，它已完成了解析。這就是所謂的只有一次，而且是所謂的最后一個處理函數。這就是所謂的后讀者已經閱讀所有輸入或已經放棄，因為一個致命的錯誤解析。 如果這個函數返回False讀者停止解析和報告錯誤。讀者使用函數[errorString](qxmlcontenthandler.html#errorString)（ ）來獲得錯誤信息。 **See also** [startDocument](qxmlcontenthandler.html#startDocument)（ ） 。 ``` bool QXmlContentHandler.endElement (self, QString?namespaceURI, QString?localName, QString?qName) ``` 這種方法是抽象的，應在任何子類中重新實現。 讀者調用該函數時，它已經被解析的限定名結束元素標記_qName_，本地名稱_localName_和命名空間URI_namespaceURI_。 如果這個函數返回False讀者停止解析和報告錯誤。讀者使用函數[errorString](qxmlcontenthandler.html#errorString)（ ）來獲得錯誤信息。 **See also** [startElement](qxmlcontenthandler.html#startElement)（）和[Namespace Support via Features](index.htm#namespace-support-via-features)。 ``` bool QXmlContentHandler.endPrefixMapping (self, QString?prefix) ``` 這種方法是抽象的，應在任何子類中重新實現。 讀者調用這個函數信號前綴映射為前綴的結束_prefix_。 如果這個函數返回False讀者停止解析和報告錯誤。讀者使用函數[errorString](qxmlcontenthandler.html#errorString)（ ）來獲得錯誤信息。 **See also** [startPrefixMapping](qxmlcontenthandler.html#startPrefixMapping)（）和[Namespace Support via Features](index.htm#namespace-support-via-features)。 ``` QString QXmlContentHandler.errorString (self) ``` 這種方法是抽象的，應在任何子類中重新實現。 讀者調用這個函數來得到一個錯誤字符串，如如有的處理函數返回False 。 ``` bool QXmlContentHandler.ignorableWhitespace (self, QString?ch) ``` 這種方法是抽象的，應在任何子類中重新實現。 有些讀者可能會使用這個功能來報告空白的每個塊元素內容。的空白報導在_ch_。 如果這個函數返回False讀者停止解析和報告錯誤。讀者使用函數[errorString](qxmlcontenthandler.html#errorString)（ ）來獲得錯誤信息。 ``` bool QXmlContentHandler.processingInstruction (self, QString?target, QString?data) ``` 這種方法是抽象的，應在任何子類中重新實現。 讀者調用該函數時，它已經解析的處理指令。 _target_作為處理指令的目標名稱和_data_在處理指令的數據。 如果這個函數返回False讀者停止解析和報告錯誤。讀者使用函數[errorString](qxmlcontenthandler.html#errorString)（ ）來獲得錯誤信息。 ``` QXmlContentHandler.setDocumentLocator (self, QXmlLocator?locator) ``` 這種方法是抽象的，應在任何子類中重新實現。 它開始解析文檔之前，讀者調用這個函數。這個論點_locator_是一個指針，指向[QXmlLocator](qxmllocator.html)它允許應用程序獲取文檔中的解析位置。 不破壞_locator_;當閱讀器被破壞它被破壞。 （請勿使用_locator_之后，讀者被破壞） 。 ``` bool QXmlContentHandler.skippedEntity (self, QString?name) ``` 這種方法是抽象的，應在任何子類中重新實現。 有些讀者可能會跳過，如果他們還沒有看到聲明的實體（例如，因為它們是在外部DTD ） 。如果他們這樣做，他們報告說，他們跳過稱為實體_name_通過調用這個函數。 如果這個函數返回False讀者停止解析和報告錯誤。讀者使用函數[errorString](qxmlcontenthandler.html#errorString)（ ）來獲得錯誤信息。 ``` bool QXmlContentHandler.startDocument (self) ``` 這種方法是抽象的，應在任何子類中重新實現。 當它開始解析文檔閱讀器調用這個函數。讀者調用這個函數只有一次，來電后[setDocumentLocator](qxmlcontenthandler.html#setDocumentLocator)（ ） ，和之前在這個類中，或在任何其他職能[QXmlDTDHandler](qxmldtdhandler.html)類調用。 如果這個函數返回False讀者停止解析和報告錯誤。讀者使用函數[errorString](qxmlcontenthandler.html#errorString)（ ）來獲得錯誤信息。 **See also** [endDocument](qxmlcontenthandler.html#endDocument)（ ） 。 ``` bool QXmlContentHandler.startElement (self, QString?namespaceURI, QString?localName, QString?qName, QXmlAttributes?atts) ``` 這種方法是抽象的，應在任何子類中重新實現。 讀者調用該函數時，它已經解析的開始元素標記。 有相應的[endElement](qxmlcontenthandler.html#endElement)（ ）調用時，相應的結束元素標籤被讀取。在startElement（）中和[endElement](qxmlcontenthandler.html#endElement)（ ）調用總是正確的嵌套。空元素標籤（例如`<x/>`）引起的startElement （ ）調用將緊跟一個[endElement](qxmlcontenthandler.html#endElement)（ ）調用。 所提供的屬性列表僅包含顯式值的屬性。在屬性列表中包含用于命名空間聲明屬性（即屬性開始的xmlns ）只有當讀者的命名空間前綴屬性為True 。 這個論點_namespaceURI_是命名空間URI ，或一個空字符串，如果該元素沒有命名空間URI，如果沒有命名空間處理完成。_localName_是本地名稱（不帶前綴） ，或者如果沒有命名空間處理完成一個空字符串，_qName_是限定名稱（帶有前綴）和_atts_頃的屬性附加到元素。如果沒有屬性，_atts_是一個空的屬性對象。 如果這個函數返回False讀者停止解析和報告錯誤。讀者使用函數[errorString](qxmlcontenthandler.html#errorString)（ ）來獲得錯誤信息。 **See also** [endElement](qxmlcontenthandler.html#endElement)（）和[Namespace Support via Features](index.htm#namespace-support-via-features)。 ``` bool QXmlContentHandler.startPrefixMapping (self, QString?prefix, QString?uri) ``` 這種方法是抽象的，應在任何子類中重新實現。 讀者調用這個函數信號的前綴， URI命名空間的映射范圍開始。這些信息是沒有必要的正常的命名空間的處理，因為讀者會自動替換為前綴的元素和屬性的名稱。 注意的startPrefixMapping （）和[endPrefixMapping](qxmlcontenthandler.html#endPrefixMapping)（ ）的調用不能保證正確嵌套相對于對方：對應前發生的所有的startPrefixMapping （ ）事件[startElement](qxmlcontenthandler.html#startElement)（）事件，以及所有[endPrefixMapping](qxmlcontenthandler.html#endPrefixMapping)（ ）對應后發生的事件[endElement](qxmlcontenthandler.html#endElement)（ ）事件，但它們的順序是沒有其他保證。 這個論點_prefix_為命名空間前綴被宣布和參數_uri_是命名空間URI的前綴映射到。 如果這個函數返回False讀者停止解析和報告錯誤。讀者使用函數[errorString](qxmlcontenthandler.html#errorString)（ ）來獲得錯誤信息。 **See also** [endPrefixMapping](qxmlcontenthandler.html#endPrefixMapping)（）和[Namespace Support via Features](index.htm#namespace-support-via-features)。