PySide6.QtWidgets.QGraphicsTextItem

class QGraphicsTextItem

QGraphicsTextItem 类提供了一个文本项，您可以将其添加到 QGraphicsScene 中以显示格式化文本。更多…

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__([parent=None])
Parameters:

父级 – QGraphicsItem

构造一个QGraphicsTextItem。parent被传递给QGraphicsItem的构造函数。

另请参阅

addItem()

__init__(text[, parent=None])
Parameters:

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

另请参阅

addItem()

adjustSize()

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

defaultTextColor()
Return type:

QColor

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

另请参阅

setDefaultTextColor()

document()
Return type:

QTextDocument

返回项目的文本文档。

另请参阅

setDocument()

font()
Return type:

QFont

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

另请参阅

setFont()

linkActivated(link)
Parameters:

链接 – str

当用户点击文本项上的链接时，会发出此信号，该链接启用了Qt::LinksAccessibleByMouse或Qt::LinksAccessibleByKeyboard。link是被点击的链接。

linkHovered(link)
Parameters:

链接 – str

当用户悬停在支持Qt::LinksAccessibleByMouse的文本项上的链接时，会发出此信号。link是用户悬停的链接。

Return type:

布尔

另请参阅

setOpenExternalLinks()

setDefaultTextColor(c)
Parameters:

c – QColor

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

另请参阅

defaultTextColor()

setDocument(document)
Parameters:

文档 – QTextDocument

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

另请参阅

document()

setExtension(extension, variant)
Parameters:
setFont(font)
Parameters:

字体 – QFont

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

另请参阅

font()

setHtml(html)
Parameters:

html – 字符串

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

另请参阅

toHtml() hasFocus() QGraphicsSimpleTextItem

Parameters:

open – 布尔值

另请参阅

openExternalLinks()

setPlainText(text)
Parameters:

文本 – str

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

另请参阅

toHtml() hasFocus()

setTabChangesFocus(b)
Parameters:

b – 布尔值

如果 b 为真，Tab 键将使小部件改变焦点；否则，Tab 键将在文档中插入一个制表符。

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

setTextCursor(cursor)
Parameters:

光标 – QTextCursor

另请参阅

textCursor()

setTextInteractionFlags(flags)
Parameters:

flags – TextInteractionFlag 的组合

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

QGraphicsTextItem 的默认值是 Qt::NoTextInteraction。此函数还会通过设置或清除 ItemIsFocusable QGraphicsItem 标志来影响它，如果 flags 与 Qt::NoTextInteraction 不同，则设置该标志，否则清除它。

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

另请参阅

textInteractionFlags()

setTextWidth(width)
Parameters:

width – 浮点数

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

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

默认值为-1。

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

supportsExtension(extension)
Parameters:

扩展 – Extension

Return type:

布尔

tabChangesFocus()
Return type:

布尔

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

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

另请参阅

setTabChangesFocus()

textCursor()
Return type:

QTextCursor

另请参阅

setTextCursor()

textInteractionFlags()
Return type:

TextInteractionFlag 的组合

返回当前的文本交互标志。

textWidth()
Return type:

浮点数

返回文本宽度。

宽度是通过QGraphicsTextItem内部维护的QTextDocument计算的。

toHtml()
Return type:

字符串

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

另请参阅

setHtml()

toPlainText()
Return type:

字符串

返回项目的文本转换为纯文本，如果未设置文本，则返回空的QString。

另请参阅

setPlainText()