En esta página

QGraphicsSimpleTextItem Class

La clase QGraphicsSimpleTextItem proporciona un elemento de texto simple que se puede añadir a un QGraphicsScene. Más...

Cabecera: #include <QGraphicsSimpleTextItem>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Hereda: QAbstractGraphicsShapeItem

Tipos Públicos

enum { Type }

Funciones Públicas

QGraphicsSimpleTextItem(QGraphicsItem *parent = nullptr)
QGraphicsSimpleTextItem(const QString &text, QGraphicsItem *parent = nullptr)
virtual ~QGraphicsSimpleTextItem()
QFont font() const
void setFont(const QFont &font)
void setText(const QString &text)
QString text() const

Funciones Públicas Reimplementadas

virtual QRectF boundingRect() const override
virtual bool contains(const QPointF &point) const override
virtual bool isObscuredBy(const QGraphicsItem *item) const override
virtual QPainterPath opaqueArea() const override
virtual void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget) override
virtual QPainterPath shape() const override
virtual int type() const override

Descripción Detallada

Para establecer el texto del elemento, puedes pasar un QString al constructor de QGraphicsSimpleTextItem, o llamar a setText() para cambiar el texto más tarde. Para establecer el color de relleno del texto, llame a setBrush().

El elemento de texto simple puede tener tanto un relleno como un contorno; setBrush() establecerá el relleno del texto (es decir, el color del texto), y setPen() establece la pluma que se utilizará para dibujar el contorno del texto. (Esto último puede ser lento, especialmente para plumas complejas, y elementos con contenido de texto largo). Si todo lo que quieres es dibujar una simple línea de texto, deberías llamar a setBrush() solamente, y dejar la pluma sin configurar; la pluma de QGraphicsSimpleTextItem es por defecto Qt::NoPen.

QGraphicsSimpleTextItem usa el tamaño del texto formateado y la fuente asociada para proporcionar una implementación razonable de boundingRect(), shape(), y contains(). Puedes establecer la fuente llamando a setFont().

QGraphicsSimpleText no muestra texto enriquecido; en su lugar, puede utilizar QGraphicsTextItem, que proporciona capacidades completas de control de texto.

Texto "Qt" con relleno y contorno personalizados dibujados cerca del origen

Ver también QGraphicsTextItem, QGraphicsPathItem, QGraphicsRectItem, QGraphicsEllipseItem, QGraphicsPixmapItem, QGraphicsPolygonItem, QGraphicsLineItem, y Graphics View Framework.

Documentación de tipos de miembros

[anonymous] enum

El valor devuelto por la función virtual type().

ConstanteValorDescripción
QGraphicsSimpleTextItem::Type9Un elemento gráfico de texto simple

Documentación de la función miembro

[explicit] QGraphicsSimpleTextItem::QGraphicsSimpleTextItem(QGraphicsItem *parent = nullptr)

Construye un QGraphicsSimpleTextItem.

parent se pasa al constructor de QGraphicsItem.

Ver también QGraphicsScene::addItem().

[explicit] QGraphicsSimpleTextItem::QGraphicsSimpleTextItem(const QString &text, QGraphicsItem *parent = nullptr)

Construye un QGraphicsSimpleTextItem, usando text como texto plano por defecto.

parent se pasa al constructor de QGraphicsItem.

Ver también QGraphicsScene::addItem().

[virtual noexcept] QGraphicsSimpleTextItem::~QGraphicsSimpleTextItem()

Destruye el QGraphicsSimpleTextItem.

[override virtual] QRectF QGraphicsSimpleTextItem::boundingRect() const

Reimplementa: QGraphicsItem::boundingRect() const.

[override virtual] bool QGraphicsSimpleTextItem::contains(const QPointF &point) const

Reimplementa: QGraphicsItem::contains(const QPointF &point) const.

QFont QGraphicsSimpleTextItem::font() const

Devuelve la fuente que se utiliza para dibujar el texto del elemento.

Véase también setFont().

[override virtual] bool QGraphicsSimpleTextItem::isObscuredBy(const QGraphicsItem *item) const

Reimplementa: QAbstractGraphicsShapeItem::isObscuredBy(const QGraphicsItem *item) const.

[override virtual] QPainterPath QGraphicsSimpleTextItem::opaqueArea() const

Reimplementa: QAbstractGraphicsShapeItem::opaqueArea() const.

[override virtual] void QGraphicsSimpleTextItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)

Reimplementa: QGraphicsItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget).

void QGraphicsSimpleTextItem::setFont(const QFont &font)

Establece la fuente que se utiliza para dibujar el texto del elemento en font.

Véase también font().

void QGraphicsSimpleTextItem::setText(const QString &text)

Establece el texto del elemento en text. El texto se mostrará como texto sin formato. Los caracteres de nueva línea ('\n') así como los caracteres de tipo QChar::LineSeparator harán que item rompa el texto en varias líneas.

Véase también text().

[override virtual] QPainterPath QGraphicsSimpleTextItem::shape() const

Reimplementa: QGraphicsItem::shape() const.

QString QGraphicsSimpleTextItem::text() const

Devuelve el texto del elemento.

Véase también setText().

[override virtual] int QGraphicsSimpleTextItem::type() const

Reimplementa: QGraphicsItem::type() const.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.