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.

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()`.
| Constante | Valor | Descripción |
|---|---|---|
QGraphicsSimpleTextItem::Type | 9 | Un 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.