QGraphicsTextItem

The QGraphicsTextItem class provides a text item that you can add to a QGraphicsScene to display formatted text. More…

Synopsis

Functions

• def adjustSize ()

• def defaultTextColor ()

• def document ()

• def font ()

• def openExternalLinks ()

• def setDefaultTextColor (c)

• def setDocument (document)

• def setFont (font)

• def setHtml (html)

• def setOpenExternalLinks (open)

• def setPlainText (text)

• def setTabChangesFocus (b)

• def setTextCursor (cursor)

• def setTextInteractionFlags (flags)

• def setTextWidth (width)

• def tabChangesFocus ()

• def textCursor ()

• def textInteractionFlags ()

• def textWidth ()

• def toHtml ()

• def toPlainText ()

Virtual functions

• def setExtension (extension, variant)

• def supportsExtension (extension)

Signals

• def linkActivated (arg__1)

• def linkHovered (arg__1)

Detailed Description

If you only need to show plain text in an item, consider using QGraphicsSimpleTextItem instead.

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() , and 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() .

Note

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.

Note

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

See also

QGraphicsSimpleTextItem QGraphicsPathItem QGraphicsRectItem QGraphicsEllipseItem QGraphicsPixmapItem QGraphicsPolygonItem QGraphicsLineItem Graphics View Framework

class PySide6.QtWidgets.QGraphicsTextItem([parent=None])

PySide6.QtWidgets.QGraphicsTextItem(text[, parent=None])

Parameters

• text – str

• parent – PySide6.QtWidgets.QGraphicsItem

Constructs a QGraphicsTextItem . parent is passed to QGraphicsItem ‘s constructor.

See also

addItem()

Constructs a QGraphicsTextItem , using text as the default plain text. parent is passed to QGraphicsItem ‘s constructor.

See also

addItem()

PySide6.QtWidgets.QGraphicsTextItem.adjustSize()

Adjusts the text item to a reasonable size.

PySide6.QtWidgets.QGraphicsTextItem.defaultTextColor()

Return type

PySide6.QtGui.QColor

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

See also

setDefaultTextColor()

PySide6.QtWidgets.QGraphicsTextItem.document()

Return type

PySide6.QtGui.QTextDocument

Returns the item’s text document.

See also

setDocument()

PySide6.QtWidgets.QGraphicsTextItem.font()

Return type

PySide6.QtGui.QFont

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

See also

setFont()

PySide6.QtWidgets.QGraphicsTextItem.linkActivated(arg__1)

Parameters

arg__1 – str

PySide6.QtWidgets.QGraphicsTextItem.linkHovered(arg__1)

Parameters

arg__1 – str

PySide6.QtWidgets.QGraphicsTextItem.openExternalLinks()

Return type

bool

See also

setOpenExternalLinks()

PySide6.QtWidgets.QGraphicsTextItem.setDefaultTextColor(c)

Parameters

c – PySide6.QtGui.QColor

Sets the color for unformatted text to col.

See also

defaultTextColor()

PySide6.QtWidgets.QGraphicsTextItem.setDocument(document)

Parameters

document – PySide6.QtGui.QTextDocument

Sets the text document document on the item.

See also

document()

PySide6.QtWidgets.QGraphicsTextItem.setExtension(extension, variant)

Parameters

• extension – Extension

• variant – object

PySide6.QtWidgets.QGraphicsTextItem.setFont(font)

Parameters

font – PySide6.QtGui.QFont

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

See also

font()

PySide6.QtWidgets.QGraphicsTextItem.setHtml(html)

Parameters

html – str

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.

See also

toHtml() hasFocus() QGraphicsSimpleTextItem

PySide6.QtWidgets.QGraphicsTextItem.setOpenExternalLinks(open)

Parameters

open – bool

See also

openExternalLinks()

PySide6.QtWidgets.QGraphicsTextItem.setPlainText(text)

Parameters

text – str

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.

See also

toHtml() hasFocus()

PySide6.QtWidgets.QGraphicsTextItem.setTabChangesFocus(b)

Parameters

b – bool

If 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.

See also

tabChangesFocus() ItemIsFocusable textInteractionFlags()

PySide6.QtWidgets.QGraphicsTextItem.setTextCursor(cursor)

Parameters

cursor – PySide6.QtGui.QTextCursor

See also

textCursor()

PySide6.QtWidgets.QGraphicsTextItem.setTextInteractionFlags(flags)

Parameters

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 flag.

See also

textInteractionFlags()

PySide6.QtWidgets.QGraphicsTextItem.setTextWidth(width)

Parameters

width – float

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.

If 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.

The default value is -1.

Note that QGraphicsTextItem keeps a QTextDocument internally, which is used to calculate the text width.

See also

textWidth() setTextWidth()

PySide6.QtWidgets.QGraphicsTextItem.supportsExtension(extension)

Parameters

extension – Extension

Return type

bool

PySide6.QtWidgets.QGraphicsTextItem.tabChangesFocus()

Return type

bool

Returns 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.

See also

setTabChangesFocus()

PySide6.QtWidgets.QGraphicsTextItem.textCursor()

Return type

PySide6.QtGui.QTextCursor

See also

setTextCursor()

PySide6.QtWidgets.QGraphicsTextItem.textInteractionFlags()

Return type

TextInteractionFlags

Returns the current text interaction flags.

See also

setTextInteractionFlags()

PySide6.QtWidgets.QGraphicsTextItem.textWidth()

Return type

float

Returns the text width.

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

See also

setTextWidth() textWidth()

PySide6.QtWidgets.QGraphicsTextItem.toHtml()

Return type

str

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

See also

setHtml()

PySide6.QtWidgets.QGraphicsTextItem.toPlainText()

Return type

str

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

See also

setPlainText()