TextItem

class pyqtgraph.TextItem(text='', color=(200, 200, 200), html=None, anchor=(0, 0), border=None, fill=None, angle=0, rotateAxis=None)[source]

GraphicsItem displaying unscaled text (the text will always appear normal even inside a scaled ViewBox).

__init__(text='', color=(200, 200, 200), html=None, anchor=(0, 0), border=None, fill=None, angle=0, rotateAxis=None)[source]

Arguments:

text

The text to display

color

The color of the text (any format accepted by pg.mkColor)

html

If specified, this overrides both text and color

anchor

A QPointF or (x,y) sequence indicating what region of the text box will be anchored to the item’s position. A value of (0,0) sets the upper-left corner of the text box to be at the position specified by setPos(), while a value of (1,1) sets the lower-right corner.

border

A pen to use when drawing the border

fill

A brush to use when filling within the border

angle

Angle in degrees to rotate text. Default is 0; text will be displayed upright.

rotateAxis

If None, then a text angle of 0 always points along the +x axis of the scene. If a QPointF or (x,y) sequence is given, then it represents a vector direction in the parent’s coordinate system that the 0-degree line will be aligned to. This Allows text to follow both the position and orientation of its parent while still discarding any scale and shear factors.

The effects of the rotateAxis and angle arguments are added independently. So for example:

  • rotateAxis=None, angle=0 -> normal horizontal text

  • rotateAxis=None, angle=90 -> normal vertical text

  • rotateAxis=(1, 0), angle=0 -> text aligned with x axis of its parent

  • rotateAxis=(0, 1), angle=0 -> text aligned with y axis of its parent

  • rotateAxis=(1, 0), angle=90 -> text orthogonal to x axis of its parent

setAngle(angle)[source]

Set the angle of the text in degrees.

This sets the rotation angle of the text as a whole, measured counter-clockwise from the x axis of the parent. Note that this rotation angle does not depend on horizontal/vertical scaling of the parent.

setColor(color)[source]

Set the color for this text.

See QtGui.QGraphicsItem.setDefaultTextColor().

setFont(*args)[source]

Set the font for this text.

See QtGui.QGraphicsTextItem.setFont().

setHtml(html)[source]

Set the HTML code to be rendered by this item.

See QtGui.QGraphicsTextItem.setHtml().

setPlainText(text)[source]

Set the plain text to be rendered by this item.

See QtGui.QGraphicsTextItem.setPlainText().

setText(text, color=None)[source]

Set the text of this item.

This method sets the plain text of the item; see also setHtml().

setTextWidth(*args)[source]

Set the width of the text.

If the text requires more space than the width limit, then it will be wrapped into multiple lines.

See QtGui.QGraphicsTextItem.setTextWidth().