class QTextFragment#

QTextFragment 存储了在 QTextDocument 中带有一个单一 QTextCharFormat 的文本片段。 更多...

概要#

方法#

注释

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对片段翻译的贡献。如果您发现翻译中存在任何问题,也可以通过在https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们

详细描述#

文本片段表示以单个字符格式存储的文本片段。字符格式发生变化的文本可以使用不同格式的文本片段序列来表示。

如果用户编辑了片段中的文本并引入了不同的字符格式,片段的文本将在格式更改的每个点被分割,并将创建新片段。例如,改变句子中间一些文本的样式将导致片段被拆分成三个独立的片段:前两个和第三个与之前的格式相同,第二个具有新的样式。第一个片段将包含句子的开头文字,第二个包含中间的文字,第三个包含句子的结尾部分。

../../_images/qtextfragment-split.png

可以使用 text()charFormat() 函数获取片段文本和字符格式。 length() 函数给出片段中文本的长度。 position() 提供文档中片段开始的定位。要确定片段是否包含文档中的特定位置,请使用 contains() 函数。

__init__()#

创建一个新的空文本片段。

__init__(o)
参数::

oQTextFragment

other文本片段的内容(文本和格式)复制到本文本片段。

charFormat()#
返回类型::

QTextCharFormat

返回文本片段的字符格式。

另请参阅

text()

charFormatIndex()#
返回类型::

int

返回text fragment的字符格式在文档内部字符格式列表中的索引。

另请参阅

allFormats()

contains(position)#
参数::

position – int

返回类型::

bool

如果text fragment在文档中包含给定的position处的文本,则返回true;否则返回false

glyphRuns([from=-1[, length=-1]])#
参数::
  • from – int

  • length – int

返回类型::

.列表 of QGlyphRun

返回从位置pos开始的len个字符对应的符号。符号的位置相对于QTextBlock布局的位置。

如果pos小于0,将默认为QTextFragment的开始。如果len小于0,将默认为片段的长度。

isValid()#
返回类型::

bool

如果这是一个有效的text fragment(即在文档中有一个有效的位置),则返回true;否则返回false

length()#
返回类型::

int

返回text fragment中的字符数。

另请参阅

text()

__ne__(o)#
参数::

oQTextFragment

返回类型::

bool

如果此文本片段与其他文本片段(在位置不同)不同,则返回true;否则返回false

__lt__(o)#
参数::

oQTextFragment

返回类型::

bool

如果此文本片段在文档中先于其他文本片段,则返回true;否则返回false

__eq__(o)#
参数::

oQTextFragment

返回类型::

bool

如果此文本片段与其他文本片段(在相同位置)相同,则返回true;否则返回false

position()#
返回类型::

int

返回此文本片段在文档中的位置。

text()#
返回类型::

str

返回文本片段的纯文本。

另请参阅

length() charFormat()