QTextDocument Class Reference · PyQt4 中文文檔

# QTextDocument Class Reference ## [[QtGui](index.htm) module] 該另外，QTextDocument類認為，可以查看和編輯使用格式化的文本[QTextEdit](qtextedit.html)。[More...](#details) 繼承[QObject](qobject.html)。 ### Types * `enum FindFlag { FindBackward, FindCaseSensitively, FindWholeWords }` * `class **[FindFlags](index.htm)**` * `enum MetaInformation { DocumentTitle, DocumentUrl }` * `enum ResourceType { HtmlResource, ImageResource, StyleSheetResource, UserResource }` * `enum Stacks { UndoStack, RedoStack, UndoAndRedoStacks }` ### Methods * `__init__ (self, QObject?parent?=?None)` * `__init__ (self, QString?text, QObject?parent?=?None)` * `addResource (self, int?type, QUrl?name, QVariant?resource)` * `adjustSize (self)` * `list-of-QTextFormat allFormats (self)` * `int availableRedoSteps (self)` * `int availableUndoSteps (self)` * `QTextBlock begin (self)` * `int blockCount (self)` * `QChar characterAt (self, int?pos)` * `int characterCount (self)` * `clear (self)` * `clearUndoRedoStacks (self, Stacks?stacks?=?QTextDocument.UndoAndRedoStacks)` * `QTextDocument clone (self, QObject?parent?=?None)` * `QTextObject createObject (self, QTextFormat?f)` * `Qt.CursorMoveStyle defaultCursorMoveStyle (self)` * `QFont defaultFont (self)` * `QString defaultStyleSheet (self)` * `QTextOption defaultTextOption (self)` * `QAbstractTextDocumentLayout documentLayout (self)` * `float documentMargin (self)` * `drawContents (self, QPainter?p, QRectF?rect?=?QRectF())` * `QTextBlock end (self)` * `QTextCursor find (self, QString?subString, int?position?=?0, FindFlags?options?=?0)` * `QTextCursor find (self, QRegExp?expr, int?position?=?0, FindFlags?options?=?0)` * `QTextCursor find (self, QString?subString, QTextCursor?cursor, FindFlags?options?=?0)` * `QTextCursor find (self, QRegExp?expr, QTextCursor?cursor, FindFlags?options?=?0)` * `QTextBlock findBlock (self, int?pos)` * `QTextBlock findBlockByLineNumber (self, int?blockNumber)` * `QTextBlock findBlockByNumber (self, int?blockNumber)` * `QTextBlock firstBlock (self)` * `float idealWidth (self)` * `float indentWidth (self)` * `bool isEmpty (self)` * `bool isModified (self)` * `bool isRedoAvailable (self)` * `bool isUndoAvailable (self)` * `bool isUndoRedoEnabled (self)` * `QTextBlock lastBlock (self)` * `int lineCount (self)` * `QVariant loadResource (self, int?type, QUrl?name)` * `markContentsDirty (self, int?from, int?length)` * `int maximumBlockCount (self)` * `QString metaInformation (self, MetaInformation?info)` * `QTextObject object (self, int?objectIndex)` * `QTextObject objectForFormat (self, QTextFormat)` * `int pageCount (self)` * `QSizeF pageSize (self)` * `print (self, QPrinter?printer)` * `print_ (self, QPrinter?printer)` * `redo (self)` * `redo (self, QTextCursor?cursor)` * `QVariant resource (self, int?type, QUrl?name)` * `int revision (self)` * `QTextFrame rootFrame (self)` * `setDefaultCursorMoveStyle (self, Qt.CursorMoveStyle?style)` * `setDefaultFont (self, QFont?font)` * `setDefaultStyleSheet (self, QString?sheet)` * `setDefaultTextOption (self, QTextOption?option)` * `setDocumentLayout (self, QAbstractTextDocumentLayout?layout)` * `setDocumentMargin (self, float?margin)` * `setHtml (self, QString?html)` * `setIndentWidth (self, float?width)` * `setMaximumBlockCount (self, int?maximum)` * `setMetaInformation (self, MetaInformation?info, QString)` * `setModified (self, bool?on?=?True)` * `setPageSize (self, QSizeF?size)` * `setPlainText (self, QString?text)` * `setTextWidth (self, float?width)` * `setUndoRedoEnabled (self, bool?enable)` * `setUseDesignMetrics (self, bool?b)` * `QSizeF size (self)` * `float textWidth (self)` * `QString toHtml (self, QByteArray?encoding?=?QByteArray())` * `QString toPlainText (self)` * `undo (self)` * `undo (self, QTextCursor?cursor)` * `bool useDesignMetrics (self)` ### Qt Signals * `void blockCountChanged (int)` * `void contentsChange (int,int,int)` * `void contentsChanged ()` * `void cursorPositionChanged (const QTextCursor&)` * `void documentLayoutChanged ()` * `void modificationChanged (bool)` * `void redoAvailable (bool)` * `void undoAvailable (bool)` * `void undoCommandAdded ()` * * * ## Detailed Description 該另外，QTextDocument類認為，可以查看和編輯使用格式化的文本[QTextEdit](qtextedit.html)。另外，QTextDocument是一個容器的結構化富文本文檔，提供了樣式的文本和各類文檔元素，例如列表，表格，框架和圖像的支持。它們可以用在被創建[QTextEdit](qtextedit.html)或獨立使用。每個文檔元素是由一個相關的格式對象描述。每種格式的對象被視為由QTextDocuments一個唯一的對象，并且可以被傳遞到[objectForFormat](qtextdocument.html#objectForFormat)（）來獲得，它被應用到文檔元素。一個另外，QTextDocument可以通過編程使用進行編輯[QTextCursor](qtextcursor.html)的，其內容可以通過遍歷文檔結構進行檢查。整個文檔結構被存儲為根框架之下文檔元素的層次結構，發現了與[rootFrame](qtextdocument.html#rootFrame)（）函數。另外，如果你只是想遍歷文檔的文本內容，您可以使用[begin](qtextdocument.html#begin)（）[end](qtextdocument.html#end)（）和[findBlock](qtextdocument.html#findBlock)（）來檢索文本塊，你可以檢查和遍歷。一個文件的布局是由確定的[documentLayout](qtextdocument.html#documentLayout)（），你可以創建自己的[QAbstractTextDocumentLayout](qabstracttextdocumentlayout.html)子類并使用它設置[setDocumentLayout](qtextdocument.html#setDocumentLayout)（）如果你想使用自己的布局邏輯。文檔的標題和其他元信息可以通過調用來獲得[metaInformation](qtextdocument.html#metaInformation)（）函數。對于通過向用戶公開文件[QTextEdit](qtextedit.html)類，文檔標題也可通過[QTextEdit.documentTitle](qtextedit.html#documentTitle-prop)（）函數。該[toPlainText](qtextdocument.html#toPlainText)（）和[toHtml](qtextdocument.html#toHtml)（）的便利功能允許您檢索文件的內容為純文本和HTML 。該文件的文本，可使用搜索的[find](qtextdocument.html#find)（）函數。對文檔進行操作的撤消/重做可使用控制[setUndoRedoEnabled](qtextdocument.html#undoRedoEnabled-prop)（）函數。撤消/重做系統可以由一個編輯控件通過被控制的[undo](qtextdocument.html#undo)（）和[redo](qtextdocument.html#redo)（）插槽，該文件還提供了[contentsChanged](qtextdocument.html#contentsChanged)（）[undoAvailable](qtextdocument.html#undoAvailable)（）和[redoAvailable](qtextdocument.html#redoAvailable)（）是通知連接編輯器部件有關撤消/重做系統的狀態信號。下面是一個另外，QTextDocument的撤消/重做操作： * Insertion or removal of characters. A sequence of insertions or removals within the same text block are regarded as a single undo/redo operation. * Insertion or removal of text blocks. Sequences of insertion or removals in a single operation (e.g., by selecting and then deleting text) are regarded as a single undo/redo operation. * Text character format changes. * Text block format changes. * Text block group format changes. * * * ## Type Documentation ``` QTextDocument.FindFlag ``` 這個枚舉說明可供選擇[QTextDocument](qtextdocument.html)的發現功能。該選項可以是或的結果一起從下面的列表： | Constant | Value | Description | | --- | --- | --- | | `QTextDocument.FindBackward` | `0x00001` | 向后搜索，而不是向前。 | | `QTextDocument.FindCaseSensitively` | `0x00002` | 默認情況下找到工作不區分大小寫。指定此選項改變行為，以區分大小寫的查找操作。 | | `QTextDocument.FindWholeWords` | `0x00004` | 使得找到匹配的唯一完整的話。 | 該FindFlags類型是一個typedef為[QFlags](index.htm)\u003cFindFlag\u003e 。它存儲FindFlag值的或組合。 ``` QTextDocument.MetaInformation ``` 該枚舉描述了不同類型的元數據信息可以被添加到文檔中。 | Constant | Value | Description | | --- | --- | --- | | `QTextDocument.DocumentTitle` | `0` | 文檔的標題。 | | `QTextDocument.DocumentUrl` | `1` | 該文檔的URL 。該[loadResource](qtextdocument.html#loadResource)相對于加載資源時（）函數使用這個URL為基礎。 | **See also** [metaInformation](qtextdocument.html#metaInformation)（）和[setMetaInformation](qtextdocument.html#setMetaInformation)（）。 ``` QTextDocument.ResourceType ``` 該枚舉描述了可以通過以下方式加載的資源類型[QTextDocument](qtextdocument.html)的[loadResource](qtextdocument.html#loadResource)（）函數。 | Constant | Value | Description | | --- | --- | --- | | `QTextDocument.HtmlResource` | `1` | 資源包含HTML 。 | | `QTextDocument.ImageResource` | `2` | 該資源包含圖像數據。目前支持的數據類型[QVariant.Pixmap](qvariant.html#Type-enum)和[QVariant.Image](qvariant.html#Type-enum)。如果相應的變量的類型是[QVariant.ByteArray](qvariant.html#Type-enum)然后Qt的嘗試使用QImage.loadFromData加載圖像。[QVariant.Icon](qvariant.html#Type-enum)目前不支持。需要的圖標轉換為支持的類型之一第一，例如使用QIcon.pixmap 。 | | `QTextDocument.StyleSheetResource` | `3` | 該資源包含CSS 。 | | `QTextDocument.UserResource` | `100` | 用戶定義資源類型的第一個可用值。 | **See also** [loadResource](qtextdocument.html#loadResource)（）。 ``` QTextDocument.Stacks ``` | Constant | Value | Description | | --- | --- | --- | | `QTextDocument.UndoStack` | `0x01` | 撤消堆棧。 | | `QTextDocument.RedoStack` | `0x02` | 重做堆棧。 | | `QTextDocument.UndoAndRedoStacks` | `UndoStack | RedoStack` | 無論是撤銷和重做堆棧。 | * * * ## Method Documentation ``` QTextDocument.__init__ (self, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個空[QTextDocument](qtextdocument.html)用給定的_parent_。 ``` QTextDocument.__init__ (self, QString?text, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個[QTextDocument](qtextdocument.html)含有純（未格式化）_text_指定，并與給定的_parent_。 ``` QTextDocument.addResource (self, int?type, QUrl?name, QVariant?resource) ``` 添加資源_resource_到資源高速緩存，用_type_和_name_作為標識符。_type_應該是從一個值[QTextDocument.ResourceType](qtextdocument.html#ResourceType-enum)。例如，您可以以從文檔中引用它添加一個圖像作為一個資源： ``` document->addResource([QTextDocument](qtextdocument.html).ImageResource, [QUrl](qurl.html)("mydata://image.png"), [QVariant](qvariant.html)(image)); ``` 該圖像可以通過被插入到文檔中的[QTextCursor](qtextcursor.html)API ： ``` [QTextImageFormat](qtextimageformat.html) imageFormat; imageFormat.setName("mydata://image.png"); cursor.insertImage(imageFormat); ``` 或者，您可以使用HTML中插入圖像`img`標籤： ``` editor->append("<img src=\"mydata://image.png\" />"); ``` ``` QTextDocument.adjustSize (self) ``` 調整文件到一個合理的規模。這個函數中引入了Qt 4.2中。 **See also** [idealWidth](qtextdocument.html#idealWidth)（）[textWidth](qtextdocument.html#textWidth-prop)和[size](qtextdocument.html#size-prop)。 ``` list-of-QTextFormat QTextDocument.allFormats (self) ``` 返回的文本格式的所有文檔中使用的格式的向量。 ``` int QTextDocument.availableRedoSteps (self) ``` 返回可用的重做步驟的數目。此功能被引入Qt的4.6 。 **See also** [isRedoAvailable](qtextdocument.html#isRedoAvailable)（）。 ``` int QTextDocument.availableUndoSteps (self) ``` 返回可用撤消的步驟數。此功能被引入Qt的4.6 。 **See also** [isUndoAvailable](qtextdocument.html#isUndoAvailable)（）。 ``` QTextBlock QTextDocument.begin (self) ``` [ 返回文檔的第一個文本塊。 ](qtextblock.html) [**See also**](qtextblock.html) [firstBlock](qtextdocument.html#firstBlock)（）。 ``` int QTextDocument.blockCount (self) ``` ``` QChar QTextDocument.characterAt (self, int?pos) ``` 返回字符的位置_pos_，或者一個空字符，如果該位置超出了范圍。此功能被引入Qt的4.5 。 **See also** [characterCount](qtextdocument.html#characterCount)（）。 ``` int QTextDocument.characterCount (self) ``` 返回本文件中的字符數。此功能被引入Qt的4.5 。 **See also** [blockCount](qtextdocument.html#blockCount-prop)（）和[characterAt](qtextdocument.html#characterAt)（）。 ``` QTextDocument.clear (self) ``` 清除文件。 ``` QTextDocument.clearUndoRedoStacks (self, Stacks?stacks?=?QTextDocument.UndoAndRedoStacks) ``` 清除由指定的堆棧_stacksToClear_。此方法清除撤消堆棧，重做堆棧，或者兩者都有（默認值）的任何命令。如果命令被清除時，適當的信號被發射，[QTextDocument.undoAvailable](qtextdocument.html#undoAvailable)（）或[QTextDocument.redoAvailable](qtextdocument.html#redoAvailable)（）。此功能被引入Qt的4.7 。 **See also** [QTextDocument.undoAvailable](qtextdocument.html#undoAvailable)（）和[QTextDocument.redoAvailable](qtextdocument.html#redoAvailable)（）。 ``` QTextDocument QTextDocument.clone (self, QObject?parent?=?None) ``` [ 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 ](qtextdocument.html) [創建一個新的](qtextdocument.html)[QTextDocument](qtextdocument.html)即這個文本文件的一個副本。_parent_是返回文本文檔的父。 ``` QTextObject QTextDocument.createObject (self, QTextFormat?f) ``` [](qtextobject.html) [創建并返回一個新的文檔對象（一](qtextobject.html)[QTextObject](qtextobject.html)），根據給定的_format_。 QTextObjects總是會得到通過這種方法創建的，所以如果你使用自定義的文本對象文檔里面你必須重新實現它。 ``` Qt.CursorMoveStyle QTextDocument.defaultCursorMoveStyle (self) ``` [](qt.html#CursorMoveStyle-enum) [默認光標的運動風格被用于所有](qt.html#CursorMoveStyle-enum)[QTextCursor](qtextcursor.html)從文檔中創建的對象。默認值是[Qt.LogicalMoveStyle](qt.html#CursorMoveStyle-enum)。此功能被引入Qt的4.8 。 **See also** [setDefaultCursorMoveStyle](qtextdocument.html#setDefaultCursorMoveStyle)（）。 ``` QFont QTextDocument.defaultFont (self) ``` [ ``` QString QTextDocument.defaultStyleSheet (self) ``` ](qfont.html) ``` QTextOption QTextDocument.defaultTextOption (self) ``` [](qtextoption.html) ``` QAbstractTextDocumentLayout QTextDocument.documentLayout (self) ``` [ 返回此文檔的文檔布局。 ](qabstracttextdocumentlayout.html) [**See also**](qabstracttextdocumentlayout.html) [setDocumentLayout](qtextdocument.html#setDocumentLayout)（）。 ``` float QTextDocument.documentMargin (self) ``` ``` QTextDocument.drawContents (self, QPainter?p, QRectF?rect?=?QRectF()) ``` 繪制與畫家文檔的內容_p_，夾在_rect_。如果_rect_是一個空矩形（默認），則該文件被涂別夾子。這個函數中引入了Qt 4.2中。 ``` QTextBlock QTextDocument.end (self) ``` [ 這個函數返回一個塊來測試該文檔的末尾，同時遍歷它。 ](qtextblock.html) ``` for (QTextBlock it = doc->begin(); it != doc->end(); it = it.next()) cout << it.text().toStdString() << endl; ``` 返回的塊是無效的，并表示文檔中的最后一個塊后，該塊。您可以使用[lastBlock](qtextdocument.html#lastBlock)（）來檢索該文件的最后一個有效的塊。 **See also** [lastBlock](qtextdocument.html#lastBlock)（）。 ``` QTextCursor QTextDocument.find (self, QString?subString, int?position?=?0, FindFlags?options?=?0) ``` [ 查找字符串的下一個出現，_subString_，在文檔中。搜索從給定的位置_cursor_，并進行轉發通過文件，除非在搜索選項另有規定。該_options_控制執行的搜索類型。返回一個游標，如果選擇的匹配_subString_被發現，否則返回空指針。如果給定的_cursor_有一個選擇，開始搜索選擇之后，否則它開始在光標所在的位置。默認情況下，搜索是區分大小寫的，并且可以在文檔中的任意位置匹配的文本。 ](qtextcursor.html) ``` QTextCursor QTextDocument.find (self, QRegExp?expr, int?position?=?0, FindFlags?options?=?0) ``` [](qtextcursor.html) [查找下一個出現的匹配正則表達式，_expr_，在文檔中。搜索從給定的位置_cursor_，并進行轉發通過文件，除非在搜索選項另有規定。該_options_控制執行的搜索類型。該](qtextcursor.html)[FindCaseSensitively](qtextdocument.html#FindFlag-enum)選項被忽略這個過載，使用QRegExp.caseSensitivity代替。返回一個游標，如果找到匹配選擇的匹配，否則返回空指針。如果給定的_cursor_有一個選擇，開始搜索選擇之后，否則它開始在光標所在的位置。默認情況下，搜索是區分大小寫的，并且可以在文檔中的任意位置匹配的文本。 ``` QTextCursor QTextDocument.find (self, QString?subString, QTextCursor?cursor, FindFlags?options?=?0) ``` [ 這是一個重載函數。查找字符串的下一個出現，_subString_，在文檔中。搜索從給定的_position_，并進行轉發通過文件，除非在搜索選項另有規定。該_options_控制執行的搜索類型。返回一個游標，如果選擇的匹配_subString_被發現，否則返回空指針。如果_position_為0 （默認），搜索將從該文檔的開頭，否則它開始在指定的位置。 ](qtextcursor.html) ``` QTextCursor QTextDocument.find (self, QRegExp?expr, QTextCursor?cursor, FindFlags?options?=?0) ``` [ 這是一個重載函數。 ](qtextcursor.html) [查找下一個出現的匹配正則表達式，_expr_，在文檔中。搜索從給定的_position_，并進行轉發通過文件，除非在搜索選項另有規定。該_options_控制執行的搜索類型。該](qtextcursor.html)[FindCaseSensitively](qtextdocument.html#FindFlag-enum)選項被忽略這個過載，使用QRegExp.caseSensitivity代替。返回一個游標，如果找到匹配選擇的匹配，否則返回空指針。如果_position_為0 （默認），搜索將從該文檔的開頭，否則它開始在指定的位置。 ``` QTextBlock QTextDocument.findBlock (self, int?pos) ``` [ 返回包含文本塊_pos_個字符。 ](qtextblock.html) ``` QTextBlock QTextDocument.findBlockByLineNumber (self, int?blockNumber) ``` [ 返回包含指定的文本塊_lineNumber_。此功能被引入Qt的4.5 。 ](qtextblock.html) [**See also**](qtextblock.html) [QTextBlock.firstLineNumber](qtextblock.html#firstLineNumber)（）。 ``` QTextBlock QTextDocument.findBlockByNumber (self, int?blockNumber) ``` [ 具有指定返回文本塊_blockNumber_。此功能被引入Qt的4.4 。 ](qtextblock.html) [**See also**](qtextblock.html) [QTextBlock.blockNumber](qtextblock.html#blockNumber)（）。 ``` QTextBlock QTextDocument.firstBlock (self) ``` [ 返回文檔的第一個文本塊。此功能被引入Qt的4.4 。 ``` float QTextDocument.idealWidth (self) ``` ](qtextblock.html) [返回文本文檔的理想寬度。的理想寬度是該文件的實際使用寬度不考慮可選的路線。它始終是\u003c=](qtextblock.html)[size](qtextdocument.html#size-prop)（），寬（）。這個函數中引入了Qt 4.2中。 **See also** [adjustSize](qtextdocument.html#adjustSize)（）和[textWidth](qtextdocument.html#textWidth-prop)。 ``` float QTextDocument.indentWidth (self) ``` ``` bool QTextDocument.isEmpty (self) ``` 返回True如果該文件是空的，否則返回False 。 ``` bool QTextDocument.isModified (self) ``` ``` bool QTextDocument.isRedoAvailable (self) ``` 返回True如果重做可用;否則返回False。 **See also** [isUndoAvailable](qtextdocument.html#isUndoAvailable)（）和[availableRedoSteps](qtextdocument.html#availableRedoSteps)（）。 ``` bool QTextDocument.isUndoAvailable (self) ``` 返回True如果撤消可用;否則返回False。 **See also** [isRedoAvailable](qtextdocument.html#isRedoAvailable)（）和[availableUndoSteps](qtextdocument.html#availableUndoSteps)（）。 ``` bool QTextDocument.isUndoRedoEnabled (self) ``` ``` QTextBlock QTextDocument.lastBlock (self) ``` [ 返回文檔的最后一個（有效）的文本塊。此功能被引入Qt的4.4 。 ``` int QTextDocument.lineCount (self) ``` 返回該文件的行數（如果布局支持）。否則，這是相同的塊的數目。此功能被引入Qt的4.5 。 ](qtextblock.html) [**See also**](qtextblock.html) [blockCount](qtextdocument.html#blockCount-prop)（）和[characterCount](qtextdocument.html#characterCount)（）。 ``` QVariant QTextDocument.loadResource (self, int?type, QUrl?name) ``` 將指定的數據加載_type_從具有給定的資源_name_。這個功能是由所謂的富文本引擎不直接通過存儲請求數據[QTextDocument](qtextdocument.html)的，但仍與它相關聯。例如，圖像是將一個名稱屬性間接引用[QTextImageFormat](qtextimageformat.html)對象。當被Qt調用，_type_是的值中的一個[QTextDocument.ResourceType](qtextdocument.html#ResourceType-enum)。如果[QTextDocument](qtextdocument.html)是的一個子對象[QTextEdit](qtextedit.html)，[QTextBrowser](qtextbrowser.html)或[QTextDocument](qtextdocument.html)本身則默認實現嘗試檢索從父數據。 ``` QTextDocument.markContentsDirty (self, int?from, int?length) ``` 標志著由給定的指定的內容_position_和_length_為“臟” ，通知它需要被重新布置的文檔。 ``` int QTextDocument.maximumBlockCount (self) ``` ``` QString QTextDocument.metaInformation (self, MetaInformation?info) ``` 返回有關指定類型的文件元信息_info_。 **See also** [setMetaInformation](qtextdocument.html#setMetaInformation)（）。 ``` QTextObject QTextDocument.object (self, int?objectIndex) ``` [ 返回與給定關聯的文本對象_objectIndex_。 ](qtextobject.html) ``` QTextObject QTextDocument.objectForFormat (self, QTextFormat) ``` [ 返回與格式相關聯的文本對象_f_。 ``` int QTextDocument.pageCount (self) ``` 返回本文件中的頁面的數量。 ](qtextobject.html) ``` QSizeF QTextDocument.pageSize (self) ``` [ ``` QTextDocument.print (self, QPrinter?printer) ``` ](qsizef.html) [打印文檔給定的_printer_。該](qsizef.html)[QPrinter](qprinter.html)必須設置正與該函數使用之前。這僅僅是一個方便的方法來整份文件打印到打印機。如果該文件是通過在一個特定的高度已經分頁[pageSize](qtextdocument.html#pageSize-prop)（）屬性在打印原樣。如果該文件不分頁，例如像在使用一個文件[QTextEdit](qtextedit.html)，那么該文件的臨時副本被創建和復制是根據的大小分成多個頁面[QPrinter](qprinter.html)的paperRect （）。默認情況下2厘米頁邊距設置在文檔中的內容。此外，當前頁碼印在每一頁的底部。需要注意的是[QPrinter.Selection](qprinter.html#PrintRange-enum)不支持的打印范圍使用此功能，因為選擇是一個屬性[QTextCursor](qtextcursor.html)。如果你有一個[QTextEdit](qtextedit.html)與您相關[QTextDocument](qtextdocument.html)那么你可以使用[QTextEdit](qtextedit.html)的print （）函數，因為[QTextEdit](qtextedit.html)有權訪問用戶的選擇。 **See also** [QTextEdit.print](qtextedit.html#print)（）。 ``` QTextDocument.print_ (self, QPrinter?printer) ``` 打印文檔給定的_printer_。該[QPrinter](qprinter.html)必須設置正與該函數使用之前。這僅僅是一個方便的方法來整份文件打印到打印機。如果該文件是通過在一個特定的高度已經分頁[pageSize](qtextdocument.html#pageSize-prop)（）屬性在打印原樣。如果該文件不分頁，例如像在使用一個文件[QTextEdit](qtextedit.html)，那么該文件的臨時副本被創建和復制是根據的大小分成多個頁面[QPrinter](qprinter.html)的paperRect （）。默認情況下2厘米頁邊距設置在文檔中的內容。此外，當前頁碼印在每一頁的底部。需要注意的是[QPrinter.Selection](qprinter.html#PrintRange-enum)不支持的打印范圍使用此功能，因為選擇是一個屬性[QTextCursor](qtextcursor.html)。如果你有一個[QTextEdit](qtextedit.html)與您相關[QTextDocument](qtextdocument.html)那么你可以使用[QTextEdit](qtextedit.html)的print （）函數，因為[QTextEdit](qtextedit.html)有權訪問用戶的選擇。 **See also** [QTextEdit.print](qtextedit.html#print)（）。 ``` QTextDocument.redo (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void redo()`。重做上的文檔上一次編輯操作，如果[redo is available](qtextdocument.html#isRedoAvailable)。提供_cursor_定位在其中的出版操作被重做的位置的末端。這個函數中引入了Qt 4.2中。 ``` QTextDocument.redo (self, QTextCursor?cursor) ``` 這是一個重載函數。重做上的文檔上一次編輯操作，如果[redo is available](qtextdocument.html#isRedoAvailable)。 ``` QVariant QTextDocument.resource (self, int?type, QUrl?name) ``` 指定的返回數據_type_從具有給定的資源_name_。這個功能是由所謂的富文本引擎不直接通過存儲請求數據[QTextDocument](qtextdocument.html)的，但仍與它相關聯。例如，圖像是將一個名稱屬性間接引用[QTextImageFormat](qtextimageformat.html)對象。資源文件中的內部緩存。如果資源不能在高速緩存中找到， loadResource叫嘗試裝載該資源。 loadResource應該那么請使用addResource將資源添加到緩存中。 **See also** [QTextDocument.ResourceType](qtextdocument.html#ResourceType-enum)。 ``` int QTextDocument.revision (self) ``` 返回文檔的版本（如果撤消已啟用）。修改是保證增加時不修改的文檔進行編輯。此功能被引入Qt的4.4 。 **See also** [QTextBlock.revision](qtextblock.html#revision)（）和[isModified](qtextdocument.html#modified-prop)（）。 ``` QTextFrame QTextDocument.rootFrame (self) ``` [ 返回文檔的根框架。 ``` QTextDocument.setDefaultCursorMoveStyle (self, Qt.CursorMoveStyle?style) ``` 設置默認光標的運動風格，以給定的_style_。此功能被引入Qt的4.8 。 ](qtextframe.html) [**See also**](qtextframe.html) [defaultCursorMoveStyle](qtextdocument.html#defaultCursorMoveStyle)（）。 ``` QTextDocument.setDefaultFont (self, QFont?font) ``` ``` QTextDocument.setDefaultStyleSheet (self, QString?sheet) ``` ``` QTextDocument.setDefaultTextOption (self, QTextOption?option) ``` ``` QTextDocument.setDocumentLayout (self, QAbstractTextDocumentLayout?layout) ``` 該_layout_說法有它的所有權轉移給Qt的。設置要使用的特定文件_layout_。以前的布局將被刪除。 **See also** [documentLayoutChanged](qtextdocument.html#documentLayoutChanged)（）。 ``` QTextDocument.setDocumentMargin (self, float?margin) ``` ``` QTextDocument.setHtml (self, QString?html) ``` 替換該文件的全部內容以在給定的HTML格式的文本_html_字符串。在HTML格式的尊重，盡可能，例如， “ \u003cb\u003e粗體\u003c / B\u003e正文”將產生的文本，其中第一個字有一個字體的粗細，給它一個大膽的外觀： “**bold**文本“ 。 **Note:**它是調用者的責任，以確保文本正確解碼時，[QString](qstring.html)包含HTML創建并傳遞給setHtml （）。 **See also** [setPlainText](qtextdocument.html#setPlainText)（）和[Supported HTML Subset](index.htm)。 ``` QTextDocument.setIndentWidth (self, float?width) ``` ``` QTextDocument.setMaximumBlockCount (self, int?maximum) ``` ``` QTextDocument.setMetaInformation (self, MetaInformation?info, QString) ``` 設置由指定類型的文件的元數據信息_info_為給定的_string_。 **See also** [metaInformation](qtextdocument.html#metaInformation)（）。 ``` QTextDocument.setModified (self, bool?on?=?True) ``` 這種方法也是一個Qt槽與C + +的簽名`void setModified(bool = 1)`。 ``` QTextDocument.setPageSize (self, QSizeF?size) ``` ``` QTextDocument.setPlainText (self, QString?text) ``` 替換該文件的整個內容與給定的純_text_。 **See also** [setHtml](qtextdocument.html#setHtml)（）。 ``` QTextDocument.setTextWidth (self, float?width) ``` ``` QTextDocument.setUndoRedoEnabled (self, bool?enable) ``` ``` QTextDocument.setUseDesignMetrics (self, bool?b) ``` ``` QSizeF QTextDocument.size (self) ``` [ ``` float QTextDocument.textWidth (self) ``` ``` QString QTextDocument.toHtml (self, QByteArray?encoding?=?QByteArray()) ``` 返回一個包含文檔的HTML表示形式的字符串。該_encoding_參數指定用于在HTML頭中的charset屬性的值。例如，如果指定'UTF - 8' ，然后將生成的HTML的開始看起來像這樣： ``` <html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"></head><body>... ``` 如果沒有指定編碼，然后不產生這樣的元信息。如果您以后在返回的HTML字符串轉換成字節數組傳輸通過網絡或保存到磁盤時，你應該指定編碼你要在這里為轉換為字節數組使用。 ](qsizef.html) [**See also**](qsizef.html) [Supported HTML Subset](index.htm)。 ``` QString QTextDocument.toPlainText (self) ``` 返回包含在文檔中的純文本。如果你想格式化信息使用[QTextCursor](qtextcursor.html)代替。 **See also** [toHtml](qtextdocument.html#toHtml)（）。 ``` QTextDocument.undo (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void undo()`。撤消對文檔的最后一個編輯操作，如果撤消可用。提供_cursor_定位在其中的出版操作已撤消的位置的末端。請參閱[Qt Undo Framework](index.htm)文檔。這個函數中引入了Qt 4.2中。 **See also** [undoAvailable](qtextdocument.html#undoAvailable)（）和[isUndoRedoEnabled](qtextdocument.html#undoRedoEnabled-prop)（）。 ``` QTextDocument.undo (self, QTextCursor?cursor) ``` 這是一個重載函數。 ``` bool QTextDocument.useDesignMetrics (self) ``` * * * ## Qt Signal Documentation ``` void blockCountChanged (int) ``` 這是該信號的默認超載。這個信號被發射時的文本塊中的文件的修改的總數。在傳遞的值_newBlockCount_是新的總和。此功能被引入Qt的4.3 。 ``` void contentsChange (int,int,int) ``` 這是該信號的默認超載。這個信號被發射時該文檔的內容更改，例如，當文本被插入或刪除，或格式化時被應用。信息提供有關_position_字符的變化發生的位置在文件中的，字符數去除（_charsRemoved_），以及字符數加（_charsAdded_）。該信號發出之前，該文檔的布局管理器會通知有關更改。這個鉤子可以讓你實現語法高亮顯示的文檔。 **See also** [QAbstractTextDocumentLayout.documentChanged](qabstracttextdocumentlayout.html#documentChanged)（）和[contentsChanged](qtextdocument.html#contentsChanged)（）。 ``` void contentsChanged () ``` 這是該信號的默認超載。這個信號被發射時該文檔的內容更改，例如，當文本被插入或刪除，或格式化時被應用。 **See also** [contentsChange](qtextdocument.html#contentsChange)（）。 ``` void cursorPositionChanged (const QTextCursor&) ``` 這是該信號的默認超載。這個信號被發射時的光標的位置改變了由于編輯操作。改變了光標在傳遞_cursor_。如果你需要一個信號，當光標移動的箭頭鍵，您可以使用[cursorPositionChanged()](qtextedit.html#cursorPositionChanged)在信號[QTextEdit](qtextedit.html)。 ``` void documentLayoutChanged () ``` 這是該信號的默認超載。當一個新的文檔布局設置這個信號被發射。此功能被引入Qt的4.4 。 **See also** [setDocumentLayout](qtextdocument.html#setDocumentLayout)（）。 ``` void modificationChanged (bool) ``` 這是該信號的默認超載。這個信號被發射時在文檔的內容改變了，影響到修改狀態的方法。如果_changed_誠然，該文件已被修改，否則為假。例如，調用SetModified之（假）上的文檔，然后插入文本引起來獲得所發出的信號。如果撤消操作，使所述的文件返回到其原始未修飾的狀態下，信號將得到再次發射。 ``` void redoAvailable (bool) ``` 這是該信號的默認超載。這個信號被發射時重做操作變得可用（_available_為True）或不可用（_available_是假的）。 ``` void undoAvailable (bool) ``` 這是該信號的默認超載。這個信號被發射時撤銷操作變得可用（_available_為True）或不可用（_available_是假的）。請參閱[Qt Undo Framework](index.htm)文檔。 **See also** [undo](qtextdocument.html#undo)（）和[isUndoRedoEnabled](qtextdocument.html#undoRedoEnabled-prop)（）。 ``` void undoCommandAdded () ``` 這是該信號的默認超載。每撤消一個新的水平被添加到時間這個信號被發射[QTextDocument](qtextdocument.html)。此功能被引入Qt的4.4 。