|  | Home · All Classes · Modules

# QGraphicsSimpleTextItem Class Reference
[QtGui module]

The QGraphicsSimpleTextItem class provides a simple text path item that you can add to a QGraphicsScene. More...

Inherits QAbstractGraphicsShapeItem.

### Methods

- __init__ (self, QGraphicsItem parent = None, QGraphicsScene scene = None)
- __init__ (self, QString, QGraphicsItem parent = None, QGraphicsScene scene = None)
- QRectF boundingRect (self)
- bool contains (self, QPointF)
- QFont font (self)
- bool isObscuredBy (self, QGraphicsItem)
- QPainterPath opaqueArea (self)
- paint (self, QPainter, QStyleOptionGraphicsItem, QWidget)
- setFont (self, QFont)
- setText (self, QString)
- QPainterPath shape (self)
- QString text (self)
- int type (self)

## Detailed Description

The QGraphicsSimpleTextItem class provides a simple text path item that you can add to a QGraphicsScene.

To set the item's text, you can either pass a QString to QGraphicsSimpleTextItem's constructor, or call setText() to change the text later. To set the text fill color, call setBrush().

The simple text item can have both a fill and an outline; setBrush() will set the text fill (i.e., text color), and setPen() sets the pen that will be used to draw the text outline. (The latter can be slow, especially for complex pens, and items with long text content.) If all you want is to draw a simple line of text, you should call setBrush() only, and leave the pen unset; QGraphicsSimpleTextItem's pen is by default Qt.NoPen.

QGraphicsSimpleTextItem 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().

QGraphicsSimpleText does not display rich text; instead, you can use QGraphicsTextItem, which provides full text control capabilities.

See also QGraphicsTextItem, QGraphicsPathItem, QGraphicsRectItem, QGraphicsEllipseItem, QGraphicsPixmapItem, QGraphicsPolygonItem, QGraphicsLineItem, and The Graphics View Framework.

## Method Documentation

### QGraphicsSimpleTextItem.__init__ (self, QGraphicsItem parent = None, QGraphicsScene scene = None)

The parent argument, if not None, causes self to be owned by Qt instead of PyQt.

The scene argument, if not None, causes self to be owned by Qt instead of PyQt.

Constructs a QGraphicsSimpleTextItem.

parent is passed to QGraphicsItem's constructor.

See also QGraphicsScene.addItem().

### QGraphicsSimpleTextItem.__init__ (self, QString, QGraphicsItem parent = None, QGraphicsScene scene = None)

The parent argument, if not None, causes self to be owned by Qt instead of PyQt.

The scene argument, if not None, causes self to be owned by Qt instead of PyQt.

Constructs a QGraphicsSimpleTextItem, using text as the default plain text.

parent is passed to QGraphicsItem's constructor.

See also QGraphicsScene.addItem().

### QRectF QGraphicsSimpleTextItem.boundingRect (self)

Reimplemented from QGraphicsItem.boundingRect().

### bool QGraphicsSimpleTextItem.contains (self, QPointF)

Reimplemented from QGraphicsItem.contains().

### QFont QGraphicsSimpleTextItem.font (self)

Returns the font that is used to draw the item's text.

See also setFont().

### bool QGraphicsSimpleTextItem.isObscuredBy (self, QGraphicsItem)

Reimplemented from QGraphicsItem.isObscuredBy().

### QPainterPath QGraphicsSimpleTextItem.opaqueArea (self)

Reimplemented from QGraphicsItem.opaqueArea().

### QGraphicsSimpleTextItem.paint (self, QPainter, QStyleOptionGraphicsItem, QWidget)

Reimplemented from QGraphicsItem.paint().

### QGraphicsSimpleTextItem.setFont (self, QFont)

Sets the font that is used to draw the item's text to font.

See also font().

### QGraphicsSimpleTextItem.setText (self, QString)

Sets the item's text to text. The text will be displayed as plain text. Newline characters ('\n') as well as characters of type QChar.LineSeparator will cause item to break the text into multiple lines.

See also text().

### QPainterPath QGraphicsSimpleTextItem.shape (self)

Reimplemented from QGraphicsItem.shape().

### QString QGraphicsSimpleTextItem.text (self)

Returns the item's text.

See also setText().

### int QGraphicsSimpleTextItem.type (self)

Reimplemented from QGraphicsItem.type().