En esta página

QGraphicsSimpleTextItem Class

La clase `QGraphicsSimpleTextItem` proporciona un elemento de texto sencillo que se puede añadir a un ` QGraphicsScene`. Más información...

Encabezado: #include <QGraphicsSimpleTextItem>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredan de: 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 posteriormente. Para establecer el color de relleno del texto, llama a ` setBrush()`.

El elemento de texto simple puede tener tanto relleno como contorno; ` setBrush()` establece el relleno del texto (es decir, el color del texto), y ` setPen()` establece el trazo que se utilizará para dibujar el contorno del texto. (Esto último puede resultar lento, especialmente con trazos complejos y elementos con contenido de texto extenso). Si lo único que se desea es dibujar una línea de texto sencilla, se debe llamar únicamente a setBrush() y dejar el trazo sin configurar; el trazo predeterminado de QGraphicsSimpleTextItem es Qt::NoPen.

QGraphicsSimpleTextItem utiliza el tamaño formateado del texto 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, se puede utilizar QGraphicsTextItem, que ofrece todas las capacidades de control de texto.

Texto «Qt» con relleno y contorno personalizados dibujado cerca del origen

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

Documentación sobre los tipos de miembros

[anonymous] enum

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

ConstanteValorDescripción
QGraphicsSimpleTextItem::Type9Un elemento de texto sencillo de gráficos

Documentación de la función miembro

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

Crea un objeto QGraphicsSimpleTextItem.

parent Se pasa al constructor de ` QGraphicsItem`.

Véase también QGraphicsScene::addItem().

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

Crea un objeto `QGraphicsSimpleTextItem`, utilizando ` text ` como texto sin formato por defecto.

parent Se pasa a el constructor de QGraphicsItem.

Véase 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 ») y los caracteres de tipo « QChar::LineSeparator » harán que el elemento divida 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.