class QGraphicsTextItem#

类 QGraphicsTextItem 提供了一个文本项，可以将它添加到 QGraphicsScene 中来显示格式化的文本。(更多)...

Inheritance diagram of PySide6.QtWidgets.QGraphicsTextItem

概述#

方法#

虚方法#

信号#

注意

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

详细描述#

如果您只需要在一个项目中显示纯文本，建议使用QGraphicsSimpleTextItem。

为了设置项目的文本，将一个QString传递给QGraphicsTextItem的构造函数，或者调用setHtml()和setPlainText()。

QGraphicsTextItem使用文本的格式化大小和相关字体来提供一个合理的实现boundingRect()，shape()，和contains()。您可以通过调用setFont()来设置字体。

您可以通过使用setTextInteractionFlags()设置Qt::TextEditorInteraction标志来使项目可编辑。

可以使用setTextWidth()设置项目首选的文本宽度，并使用textWidth()获取它。

注意

为了在项目中居中对齐HTML文本，必须设置文本宽度。否则，您可以在设置项目文本之后调用adjustSize()。

../../_images/graphicsview-textitem.png

注意

QGraphicsTextItem默认接受hover events。您可以通过setAcceptHoverEvents()来更改这一点。

另请参阅

QGraphicsSimpleTextItem QGraphicsPathItem QGraphicsRectItem QGraphicsEllipseItem QGraphicsPixmapItem QGraphicsPolygonItem QGraphicsLineItem 图形视图框架

__init__(text[, parent=None])#
参数:

使用text作为默认纯文本构建一个QGraphicsTextItem，parent传递给QGraphicsItem 构造函数。

另请参阅

addItem()

__init__([parent=None])
参数:

parent – QGraphicsItem

构建一个QGraphicsTextItem。将parent传递给QGraphicsItem构造函数。

另请参阅

addItem()

adjustSize()#

调整文本项到一个合理的大小。

defaultTextColor()#
返回类型:

QColor

返回用于非格式化文本的默认文本颜色。

另请参阅

setDefaultTextColor()

document()#
返回类型:

QTextDocument

返回项的文本文档。

另请参阅

setDocument()

font()#
返回类型:

QFont

返回用于渲染文本的项字体。

另请参阅

setFont()

linkActivated(arg__1)#
参数:

arg__1 – str

此信号在用户点击文本项中的链接并启用Qt::LinksAccessibleByMouse或Qt::LinksAccessibleByKeyboard时发出。link是被点击的链接。

linkHovered(arg__1)#
参数:

arg__1 – str

当用户将鼠标悬停在文本项的链接上并启用Qt::LinksAccessibleByMouse时，会发出此信号。link是被悬停的链接。

返回类型:

bool

另请参阅

setOpenExternalLinks()

setDefaultTextColor(c)#
参数:

c – QColor

将未格式化文本的颜色设置为col。

另请参阅

defaultTextColor()

setDocument(document)#
参数:

document – QTextDocument

在项目上设置文本文档document。

另请参阅

document()

setExtension(extension, variant)#
参数:
setFont(font)#
参数:

font – QFont

将用于渲染文本项的字体设置为font。

另请参阅

font()

setHtml(html)#
参数:

html – str

将项目的文本设置为text，假设文本是HTML格式。如果项目有键盘输入焦点，此函数还将调用ensureVisible()以确保文本在所有视口中可见。

另请参阅

toHtml() hasFocus() QGraphicsSimpleTextItem

参数:

open – bool

另请参阅

openExternalLinks()

setPlainText(text)链接到此处
参数:

text – 字符串

将项目的文本设置为 text。如果项目具有键盘输入焦点，此函数还会调用 ensureVisible() 确保文本在所有视图中都可见。

另请参阅

toHtml() hasFocus()

setTabChangesFocus(b)链接到此处
参数:

b – bool

如果 b 为真，则 Tab 键会导致小部件切换焦点；否则，Tab 键将向文档中插入制表符。

在某些情况下，文本编辑不应允许用户使用 Tab 键输入制表符或改变缩进，因为这会破坏焦点链。默认为 false。

setTextCursor(cursor)链接到此处
参数:

cursor – QTextCursor

另请参阅

textCursor()

setTextInteractionFlags 链接到此处
参数:

flags – 组合 TextInteractionFlag

将标志 flags 设置为指定文本项目应如何响应用户输入。

默认情况下，一个QGraphicsTextItem的设置为Qt::NoTextInteraction。此函数还通过设置该项，如果flags不是Qt::NoTextInteraction，则清除ItemIsFocusable QGraphicsItem标志来影响它。

默认情况下，文本为只读。要将项目转换为编辑器，请设置Qt::TextEditable标志。

另请参阅

textInteractionFlags()

setTextWidth(width)#
参数:

宽度 – float

设置项目文本的首选宽度。如果实际文本比指定的宽度宽，则文本将被分成多个行。

如果将宽度设置为-1，则除非通过显式的换行符或新段落强制，否则文本不会分成多行。

默认值为-1。

请注意，QGraphicsTextItem内部保持了一个QTextDocument，用于计算文本宽度。

supportsExtension(extension)#
参数:

extension – Extension

返回类型:

bool

tabChangesFocus()#
返回类型:

bool

如果Tab键会导致小部件改变焦点，则返回true；否则返回false。

默认情况下，此行为禁用，此函数将返回false。

另请参阅

setTabChangesFocus()

textCursor()#
返回类型:

QTextCursor

另请参阅

setTextCursor()

textInteractionFlags()#
返回类型:

TextInteractionFlag的组合

返回当前文本交互标志。

textWidth()#
返回类型:

float

返回文本宽度。

宽度使用QGraphicsTextItem内部保持的QTextDocument进行计算。

toHtml()#
返回类型:

str

返回项目文本的HTML转换结果，如果没有设置文本，则返回空的QString。

另请参阅

setHtml()

toPlainText()#
返回类型:

str

返回项目文本的纯文本转换结果，如果没有设置文本，则返回空的QString。

另请参阅

setPlainText()