QXmlFormatter Class Reference · PyQt4 中文文檔

# QXmlFormatter Class Reference ## [[QtXmlPatterns](index.htm) module] 該QXmlFormatter類是一個實現[QXmlSerializer](qxmlserializer.html)轉化[XQuery](index.htm)輸出成XML格式。[More...](#details) 繼承[QXmlSerializer](qxmlserializer.html)。 ### Methods * `__init__ (self, QXmlQuery?query, QIODevice?outputDevice)` * `atomicValue (self, QVariant?value)` * `attribute (self, QXmlName?name, QStringRef?value)` * `characters (self, QStringRef?value)` * `comment (self, QString?value)` * `endDocument (self)` * `endElement (self)` * `endOfSequence (self)` * `int indentationDepth (self)` * `processingInstruction (self, QXmlName?name, QString?value)` * `setIndentationDepth (self, int?depth)` * `startDocument (self)` * `startElement (self, QXmlName?name)` * `startOfSequence (self)` * * * ## Detailed Description 該QXmlFormatter類是一個實現[QXmlSerializer](qxmlserializer.html)轉化[XQuery](index.htm)輸出成XML格式。 QXmlFormatter是的一個子類[QXmlSerializer](qxmlserializer.html)該格式化XML輸出，以方便人們閱讀。 [QXmlSerializer](qxmlserializer.html)輸出的XML無需增加不必要的空格。特別是，它不加_newlines_和縮進。為了使XML輸出更易于閱讀， QXmlFormatter增加_newlines_和縮進通過添加，刪除和修改[sequence nodes](qabstractxmlreceiver.html#xquery-sequence)僅包含空白的。它還會修改空格在其他地方是不顯著，例如，屬性之間以及在文檔序幕。例如，其中基類[QXmlSerializer](qxmlserializer.html)將輸出這樣的： ``` <a><c/>Some Text</a> ``` QXmlFormatter輸出這樣的： ``` <a> <c/> Some Text </a> ``` 如果你只是想在一個人類可讀的格式序列化的XML ，使用QXmlFormatter因為它是。默認的縮進級別為4個空格，但你可以設置你自己的縮進值[setIndentationDepth](qxmlformatter.html#setIndentationDepth)（）。該_newlines_和縮進由QXmlFormatter加入適用于常見的格式，如XHTML ，SVG或Docbook的，空白的地方不顯著。但是，如果你的XML將被用作輸入空白的地方是顯著，那么你必須編寫自己的子類[QXmlSerializer](qxmlserializer.html) or [QAbstractXmlReceiver](qabstractxmlreceiver.html)。請注意，使用QXmlFormatter代替[QXmlSerializer](qxmlserializer.html)會增加計算開銷和存儲文件大小，由于空白的插入。另請注意，縮進風格采用QXmlFormatter保持松散定義和Qt中的未來版本可能會改變。如果一個特定的縮進風格需要那么無論使用基類[QXmlSerializer](qxmlserializer.html)直接，或編寫自己的子類[QXmlSerializer](qxmlserializer.html) or [QAbstractXmlReceiver](qabstractxmlreceiver.html)。或者，你可以繼承QXmlFormatter和重新實現回調那里。 ``` [QXmlQuery](qxmlquery.html) query; query.setQuery("doc('index.html')/html/body/p[1]"); QXmlFormatter formatter(query, myOutputDevice); formatter.setIndentationDepth(2); query.evaluateTo(&formatter); ``` * * * ## Method Documentation ``` QXmlFormatter.__init__ (self, QXmlQuery?query, QIODevice?outputDevice) ``` 構造一個使用的名稱游泳池和消息處理程序格式化_query_，并把結果寫入_outputDevice_作為格式化的XML 。 _outputDevice_被直接傳遞到[QXmlSerializer](qxmlserializer.html)的構造。 **See also** [QXmlSerializer](qxmlserializer.html)。 ``` QXmlFormatter.atomicValue (self, QVariant?value) ``` 從重新實現[QAbstractXmlReceiver.atomicValue](qabstractxmlreceiver.html#atomicValue)（）。 ``` QXmlFormatter.attribute (self, QXmlName?name, QStringRef?value) ``` ``` QXmlFormatter.characters (self, QStringRef?value) ``` 從重新實現[QAbstractXmlReceiver.characters](qabstractxmlreceiver.html#characters)（）。 ``` QXmlFormatter.comment (self, QString?value) ``` 從重新實現[QAbstractXmlReceiver.comment](qabstractxmlreceiver.html#comment)（）。 ``` QXmlFormatter.endDocument (self) ``` 從重新實現[QAbstractXmlReceiver.endDocument](qabstractxmlreceiver.html#endDocument)（）。 ``` QXmlFormatter.endElement (self) ``` 從重新實現[QAbstractXmlReceiver.endElement](qabstractxmlreceiver.html#endElement)（）。 ``` QXmlFormatter.endOfSequence (self) ``` 從重新實現[QAbstractXmlReceiver.endOfSequence](qabstractxmlreceiver.html#endOfSequence)（）。 ``` int QXmlFormatter.indentationDepth (self) ``` 返回的空格數[QXmlFormatter](qxmlformatter.html)將輸出每個縮進級別。默認值是4 。 **See also** [setIndentationDepth](qxmlformatter.html#setIndentationDepth)（）。 ``` QXmlFormatter.processingInstruction (self, QXmlName?name, QString?value) ``` 從重新實現[QAbstractXmlReceiver.processingInstruction](qabstractxmlreceiver.html#processingInstruction)（）。 ``` QXmlFormatter.setIndentationDepth (self, int?depth) ``` Sets _depth_是的空格數[QXmlFormatter](qxmlformatter.html)將輸出縮進的水平。默認值是4 。 **See also** [indentationDepth](qxmlformatter.html#indentationDepth)（）。 ``` QXmlFormatter.startDocument (self) ``` 從重新實現[QAbstractXmlReceiver.startDocument](qabstractxmlreceiver.html#startDocument)（）。 ``` QXmlFormatter.startElement (self, QXmlName?name) ``` 從重新實現[QAbstractXmlReceiver.startElement](qabstractxmlreceiver.html#startElement)（）。 ``` QXmlFormatter.startOfSequence (self) ``` 從重新實現[QAbstractXmlReceiver.startOfSequence](qabstractxmlreceiver.html#startOfSequence)（）。