# QTextFrame Class Reference ## [[QtGui](index.htm) module] 該QTextFrame類表示一幀[QTextDocument](qtextdocument.html)。[More...](#details) 繼承[QTextObject](qtextobject.html)。 通過繼承[QTextTable](qtexttable.html)。 ### Types * `class **[iterator](index.htm)**` ### Methods * `__init__ (self, QTextDocument?doc)` * `iterator begin (self)` * `list-of-QTextFrame childFrames (self)` * `iterator end (self)` * `QTextCursor firstCursorPosition (self)` * `int firstPosition (self)` * `QTextFrameFormat frameFormat (self)` * `QTextCursor lastCursorPosition (self)` * `int lastPosition (self)` * `QTextFrame parentFrame (self)` * `setFrameFormat (self, QTextFrameFormat?aformat)` * * * ## Detailed Description 該QTextFrame類表示一幀[QTextDocument](qtextdocument.html)。 文本框的文檔中的文本提供結構。它們被用作通用的容器，其他的文檔元素。幀通常是通過使用建立的[QTextCursor.insertFrame](qtextcursor.html#insertFrame)（ ） 。 框架可以用來創建分層結構的富文本文檔。每個文檔都有一個根框架（[QTextDocument.rootFrame](qtextdocument.html#rootFrame)（ ） ） ，根框架下的每一幀都有一個父框架和子框架的一個（可能為空）列表。父框架可以被發現[parentFrame](qtextframe.html#parentFrame)（ ）和[childFrames](qtextframe.html#childFrames)（）函數提供子框架的列表。 每個幀包含至少一個文本塊，使文字游標中插入新的文檔元素。其結果是，在[QTextFrame.iterator](index.htm)類是用來給定的框架內穿越兩個塊和子框架。在該幀中的第一個和最后一個子元素可以與發現[begin](qtextframe.html#begin)（）和[end](qtextframe.html#end)（ ） 。 幀也有使用的格式（指定[QTextFrameFormat](qtextframeformat.html)），它可與設置[setFormat](qtextobject.html#setFormat)（）和read與[format](qtextobject.html#format)（ ） 。 文字游標可以得到該點到框架內的第一個和最后一個有效的光標位置;使用[firstCursorPosition](qtextframe.html#firstCursorPosition)（）和[lastCursorPosition](qtextframe.html#lastCursorPosition)（ ）這個函數。在文檔中的幀的幅度可以與發現[firstPosition](qtextframe.html#firstPosition)（）和[lastPosition](qtextframe.html#lastPosition)（ ） 。 您可以使用在一幀中的內容重復的[QTextFrame.iterator](index.htm)類：這提供了其內部文本塊和子幀的列表只讀訪問。 * * * ## Method Documentation ``` QTextFrame.__init__ (self, QTextDocument?doc) ``` 創建文本一個新的空框架_document_。 ``` iterator QTextFrame.begin (self) ``` [](index.htm) [返回一個迭代器指向框架內的第一個文檔元素。請參閱文檔](index.htm)[STL-style-Iterators](index.htm#stl-style-iterators)了解更多信息。 **See also** [end](qtextframe.html#end)（ ） 。 ``` list-of-QTextFrame QTextFrame.childFrames (self) ``` 返回框架的子框架的一個（可能為空）列表。 **See also** [parentFrame](qtextframe.html#parentFrame)（ ） 。 ``` iterator QTextFrame.end (self) ``` [](index.htm) [返回一個迭代器，指向過去的框架內的最后一個文檔元素的位置。請參閱文檔](index.htm)[STL-Style Iterators](index.htm#stl-style-iterators)了解更多信息。 **See also** [begin](qtextframe.html#begin)（ ） 。 ``` QTextCursor QTextFrame.firstCursorPosition (self) ``` [ 返回框架內的第一個光標位置。 ](qtextcursor.html) [**See also**](qtextcursor.html) [lastCursorPosition](qtextframe.html#lastCursorPosition)（ ）[firstPosition](qtextframe.html#firstPosition)（）和[lastPosition](qtextframe.html#lastPosition)（ ） 。 ``` int QTextFrame.firstPosition (self) ``` 返回框架內的第一個文件的位置。 **See also** [lastPosition](qtextframe.html#lastPosition)（ ）[firstCursorPosition](qtextframe.html#firstCursorPosition)（）和[lastCursorPosition](qtextframe.html#lastCursorPosition)（ ） 。 ``` QTextFrameFormat QTextFrame.frameFormat (self) ``` [ 返回幀的格式。 ](qtextframeformat.html) [**See also**](qtextframeformat.html) [setFrameFormat](qtextframe.html#setFrameFormat)（ ） 。 ``` QTextCursor QTextFrame.lastCursorPosition (self) ``` [ 返回框架內的一個光標位置。 ](qtextcursor.html) [**See also**](qtextcursor.html) [firstCursorPosition](qtextframe.html#firstCursorPosition)（ ）[firstPosition](qtextframe.html#firstPosition)（）和[lastPosition](qtextframe.html#lastPosition)（ ） 。 ``` int QTextFrame.lastPosition (self) ``` 返回框架內的最后一份文件的位置。 **See also** [firstPosition](qtextframe.html#firstPosition)（ ）[firstCursorPosition](qtextframe.html#firstCursorPosition)（）和[lastCursorPosition](qtextframe.html#lastCursorPosition)（ ） 。 ``` QTextFrame QTextFrame.parentFrame (self) ``` [ 返回框架的父框架。如果該幀是一個文件的根幀，這將返回0。 ](qtextframe.html) [**See also**](qtextframe.html) [childFrames](qtextframe.html#childFrames)（）和[QTextDocument.rootFrame](qtextdocument.html#rootFrame)（ ） 。 ``` QTextFrame.setFrameFormat (self, QTextFrameFormat?aformat) ``` 設置幀的_format_。 **See also** [frameFormat](qtextframe.html#frameFormat)（ ） 。