QGraphicsTextItem ¶

概要 ¶

详细描述 ¶

若只需要在项中展示纯文本，请考虑使用 QGraphicsSimpleTextItem 代替。

To set the item’s text, pass a QString to QGraphicsTextItem ‘s constructor, or call setHtml() / setPlainText() .

QGraphicsTextItem uses the text’s formatted size and the associated font to provide a reasonable implementation of boundingRect() , shape() ，和 contains() . You can set the font by calling setFont() .

It is possible to make the item editable by setting the TextEditorInteraction flag using setTextInteractionFlags() .

The item’s preferred text width can be set using setTextWidth() and obtained using textWidth() .

注意

In order to align HTML text in the center, the item’s text width must be set. Otherwise, you can call adjustSize() after setting the item’s text.

注意

QGraphicsTextItem accepts hover events by default. You can change this with setAcceptHoverEvents() .

另请参阅

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

class QGraphicsTextItem ( [ parent=None ] ) ¶

QGraphicsTextItem(text[, parent=None])

param parent

QGraphicsItem

param text

unicode

构造 QGraphicsTextItem . parent 会被传递给 QGraphicsItem ‘s constructor.

另请参阅

addItem()

构造 QGraphicsTextItem ，使用 text 作为默认纯文本。 parent 会被传递给 QGraphicsItem ‘s constructor.

另请参阅

addItem()

PySide2.QtWidgets.QGraphicsTextItem. adjustSize ( ) ¶

Adjusts the text item to a reasonable size.

PySide2.QtWidgets.QGraphicsTextItem. defaultTextColor ( ) ¶

返回类型

QColor

Returns the default text color that is used for unformatted text.

另请参阅

setDefaultTextColor()

PySide2.QtWidgets.QGraphicsTextItem. document ( ) ¶

返回类型

QTextDocument

Returns the item’s text document.

另请参阅

setDocument()

PySide2.QtWidgets.QGraphicsTextItem. font ( ) ¶

返回类型

QFont

Returns the item’s font, which is used to render the text.

另请参阅

setFont()

PySide2.QtWidgets.QGraphicsTextItem. linkActivated ( arg__1 ) ¶

参数

arg__1 – unicode

PySide2.QtWidgets.QGraphicsTextItem. linkHovered ( arg__1 ) ¶

参数

arg__1 – unicode

PySide2.QtWidgets.QGraphicsTextItem. openExternalLinks ( ) ¶

返回类型

bool

另请参阅

setOpenExternalLinks()

PySide2.QtWidgets.QGraphicsTextItem. setDefaultTextColor ( c ) ¶

参数

c – QColor

Sets the color for unformatted text to col .

另请参阅

defaultTextColor()

PySide2.QtWidgets.QGraphicsTextItem. setDocument ( document ) ¶

参数

document – QTextDocument

Sets the text document document on the item.

另请参阅

document()

PySide2.QtWidgets.QGraphicsTextItem. setExtension ( extension , variant ) ¶

参数

• extension – Extension

• variant – object

PySide2.QtWidgets.QGraphicsTextItem. setFont ( font ) ¶

参数

font – QFont

Sets the font used to render the text item to font .

另请参阅

font()

PySide2.QtWidgets.QGraphicsTextItem. setHtml ( html ) ¶

参数

html – unicode

Sets the item’s text to text , assuming that text is HTML formatted. If the item has keyboard input focus, this function will also call ensureVisible() to ensure that the text is visible in all viewports.

另请参阅

toHtml() hasFocus() QGraphicsSimpleTextItem

PySide2.QtWidgets.QGraphicsTextItem. setOpenExternalLinks ( open ) ¶

参数

open – bool

另请参阅

openExternalLinks()

PySide2.QtWidgets.QGraphicsTextItem. setPlainText ( text ) ¶

参数

text – unicode

Sets the item’s text to text . If the item has keyboard input focus, this function will also call ensureVisible() to ensure that the text is visible in all viewports.

另请参阅

toHtml() hasFocus()

PySide2.QtWidgets.QGraphicsTextItem. setTabChangesFocus ( b ) ¶

参数

b – bool

若 b is true, the Tab key will cause the widget to change focus; otherwise, the tab key will insert a tab into the document.

In some occasions text edits should not allow the user to input tabulators or change indentation using the Tab key, as this breaks the focus chain. The default is false.

另请参阅

tabChangesFocus() ItemIsFocusable textInteractionFlags()

PySide2.QtWidgets.QGraphicsTextItem. setTextCursor ( cursor ) ¶

参数

cursor – QTextCursor

另请参阅

textCursor()

PySide2.QtWidgets.QGraphicsTextItem. setTextInteractionFlags ( flags ) ¶

参数

flags – TextInteractionFlags

Sets the flags flags to specify how the text item should react to user input.

The default for a QGraphicsTextItem is NoTextInteraction . This function also affects the ItemIsFocusable QGraphicsItem flag by setting it if flags is different from NoTextInteraction and clearing it otherwise.

By default, the text is read-only. To transform the item into an editor, set the TextEditable 标志。

另请参阅

textInteractionFlags()

PySide2.QtWidgets.QGraphicsTextItem. setTextWidth ( width ) ¶

参数

width – qreal

Sets the preferred width for the item’s text. If the actual text is wider than the specified width then it will be broken into multiple lines.

若 width is set to -1 then the text will not be broken into multiple lines unless it is enforced through an explicit line break or a new paragraph.

默认值为 -1。

注意： QGraphicsTextItem keeps a QTextDocument internally, which is used to calculate the text width.

另请参阅

textWidth() setTextWidth()

PySide2.QtWidgets.QGraphicsTextItem. supportsExtension ( extension ) ¶

参数

extension – Extension

返回类型

bool

PySide2.QtWidgets.QGraphicsTextItem. tabChangesFocus ( ) ¶

返回类型

bool

返回 true if the Tab key will cause the widget to change focus; otherwise, false is returned.

By default, this behavior is disabled, and this function will return false.

另请参阅

setTabChangesFocus()

PySide2.QtWidgets.QGraphicsTextItem. textCursor ( ) ¶

返回类型

QTextCursor

另请参阅

setTextCursor()

PySide2.QtWidgets.QGraphicsTextItem. textInteractionFlags ( ) ¶

返回类型

TextInteractionFlags

Returns the current text interaction flags.

另请参阅

setTextInteractionFlags()

PySide2.QtWidgets.QGraphicsTextItem. textWidth ( ) ¶

返回类型

qreal

Returns the text width.

The width is calculated with the QTextDocument that QGraphicsTextItem keeps internally.

另请参阅

setTextWidth() textWidth()

PySide2.QtWidgets.QGraphicsTextItem. toHtml ( ) ¶

返回类型

unicode

Returns the item’s text converted to HTML, or an empty QString if no text has been set.

另请参阅

setHtml()

PySide2.QtWidgets.QGraphicsTextItem. toPlainText ( ) ¶

返回类型

unicode

Returns the item’s text converted to plain text, or an empty QString if no text has been set.

另请参阅

setPlainText()