QGraphicsTextItem Class
La clase `QGraphicsTextItem` proporciona un elemento de texto que se puede añadir a un ` QGraphicsScene ` para mostrar texto con formato. Más información...
| Encabezado: | #include <QGraphicsTextItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado de: | QGraphicsObject |
Tipos públicos
| enum { Type } |
Propiedades
- openExternalLinks : bool
- textCursor : QTextCursor
Funciones públicas
| QGraphicsTextItem(QGraphicsItem *parent = nullptr) | |
| QGraphicsTextItem(const QString &text, QGraphicsItem *parent = nullptr) | |
| virtual | ~QGraphicsTextItem() |
| void | adjustSize() |
| QColor | defaultTextColor() const |
| QTextDocument * | document() const |
| QFont | font() const |
| bool | openExternalLinks() const |
| void | setDefaultTextColor(const QColor &col) |
| void | setDocument(QTextDocument *document) |
| void | setFont(const QFont &font) |
| void | setHtml(const QString &text) |
| void | setOpenExternalLinks(bool open) |
| void | setPlainText(const QString &text) |
| void | setTabChangesFocus(bool b) |
| void | setTextCursor(const QTextCursor &cursor) |
| void | setTextInteractionFlags(Qt::TextInteractionFlags flags) |
| void | setTextWidth(qreal width) |
| bool | tabChangesFocus() const |
| QTextCursor | textCursor() const |
| Qt::TextInteractionFlags | textInteractionFlags() const |
| qreal | textWidth() const |
| QString | toHtml() const |
| QString | toPlainText() 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 |
Señales
| void | linkActivated(const QString &link) |
| void | linkHovered(const QString &link) |
Funciones protegidas reimplementadas
| virtual void | contextMenuEvent(QGraphicsSceneContextMenuEvent *event) override |
| virtual void | dragEnterEvent(QGraphicsSceneDragDropEvent *event) override |
| virtual void | dragLeaveEvent(QGraphicsSceneDragDropEvent *event) override |
| virtual void | dragMoveEvent(QGraphicsSceneDragDropEvent *event) override |
| virtual void | dropEvent(QGraphicsSceneDragDropEvent *event) override |
| virtual void | focusInEvent(QFocusEvent *event) override |
| virtual void | focusOutEvent(QFocusEvent *event) override |
| virtual void | hoverEnterEvent(QGraphicsSceneHoverEvent *event) override |
| virtual void | hoverLeaveEvent(QGraphicsSceneHoverEvent *event) override |
| virtual void | hoverMoveEvent(QGraphicsSceneHoverEvent *event) override |
| virtual void | inputMethodEvent(QInputMethodEvent *event) override |
| virtual QVariant | inputMethodQuery(Qt::InputMethodQuery query) const override |
| virtual void | keyPressEvent(QKeyEvent *event) override |
| virtual void | keyReleaseEvent(QKeyEvent *event) override |
| virtual void | mouseDoubleClickEvent(QGraphicsSceneMouseEvent *event) override |
| virtual void | mouseMoveEvent(QGraphicsSceneMouseEvent *event) override |
| virtual void | mousePressEvent(QGraphicsSceneMouseEvent *event) override |
| virtual void | mouseReleaseEvent(QGraphicsSceneMouseEvent *event) override |
| virtual bool | sceneEvent(QEvent *event) override |
Descripción detallada
Si solo necesitas mostrar texto sin formato en un elemento, plantéate utilizar en su lugar QGraphicsSimpleTextItem.
Para establecer el texto del elemento, pasa un ` QString ` al constructor de `QGraphicsTextItem`, o llama a ` setHtml()` / `setPlainText()`.
QGraphicsTextItem utiliza el tamaño formateado del texto y la fuente asociada para proporcionar una implementación adecuada de boundingRect(), shape() y contains(). Puede establecer la fuente llamando a setFont().
Es posible hacer que el elemento sea editable configurando el indicador « Qt::TextEditorInteraction » mediante la función « setTextInteractionFlags()».
El ancho de texto preferido del elemento se puede establecer mediante setTextWidth() y obtener mediante textWidth().
Nota: Para alinear el texto HTML en el centro, es necesario establecer el ancho de texto del elemento. De lo contrario, puedes llamar a ` adjustSize()` después de establecer el texto del elemento.

Nota: QGraphicsTextItem acepta hover events por defecto. Se puede cambiar esta configuración con setAcceptHoverEvents().
Véase también QGraphicsSimpleTextItem, QGraphicsPathItem, QGraphicsRectItem, QGraphicsEllipseItem, QGraphicsPixmapItem, QGraphicsPolygonItem, QGraphicsLineItem y Graphics View Framework.
Documentación sobre los tipos de miembro
[anonymous] enum
El valor devuelto por la función virtual ` type()`.
| Constante | Valor | Descripción |
|---|---|---|
QGraphicsTextItem::Type | 8 | Un elemento de texto gráfico |
Documentación de la propiedad
openExternalLinks : bool
Especifica si QGraphicsTextItem debe abrir automáticamente los enlaces utilizando QDesktopServices::openUrl() en lugar de emitir la señal linkActivated.
El valor por defecto es false.
Funciones de acceso:
| bool | openExternalLinks() const |
| void | setOpenExternalLinks(bool open) |
textCursor : QTextCursor
Esta propiedad representa el cursor de texto visible en un elemento de texto editable.
Por defecto, si no se ha establecido el texto del elemento, esta propiedad contiene un cursor de texto nulo; en caso contrario, contiene un cursor de texto situado al principio del documento del elemento.
Funciones de acceso:
| QTextCursor | textCursor() const |
| void | setTextCursor(const QTextCursor &cursor) |
Documentación de las funciones de miembro
[explicit] QGraphicsTextItem::QGraphicsTextItem(QGraphicsItem *parent = nullptr)
Crea un objeto `QGraphicsTextItem`. Se pasa ` parent ` al constructor de ` QGraphicsItem`.
Véase también QGraphicsScene::addItem().
[explicit] QGraphicsTextItem::QGraphicsTextItem(const QString &text, QGraphicsItem *parent = nullptr)
Crea un objeto `QGraphicsTextItem` utilizando ` text ` como texto sin formato predeterminado. Se pasa ` parent ` al constructor de ` QGraphicsItem`.
Véase también QGraphicsScene::addItem().
[virtual noexcept] QGraphicsTextItem::~QGraphicsTextItem()
Destruye el « QGraphicsTextItem ».
void QGraphicsTextItem::adjustSize()
Ajusta el elemento de texto a un tamaño razonable.
[override virtual] QRectF QGraphicsTextItem::boundingRect() const
Reimplementa: ` QGraphicsItem::boundingRect()` const.
[override virtual] bool QGraphicsTextItem::contains(const QPointF &point) const
Reimplementa: ` QGraphicsItem::contains(const QPointF &point) const`.
[override virtual protected] void QGraphicsTextItem::contextMenuEvent(QGraphicsSceneContextMenuEvent *event)
Reimplementa: ` QGraphicsItem::contextMenuEvent(QGraphicsSceneContextMenuEvent *event)`.
QColor QGraphicsTextItem::defaultTextColor() const
Devuelve el color de texto predeterminado que se utiliza para el texto sin formato.
Véase también setDefaultTextColor().
QTextDocument *QGraphicsTextItem::document() const
Devuelve el documento de texto del elemento.
Véase también setDocument().
[override virtual protected] void QGraphicsTextItem::dragEnterEvent(QGraphicsSceneDragDropEvent *event)
Reimplementa: QGraphicsItem::dragEnterEvent(QGraphicsSceneDragDropEvent *event).
[override virtual protected] void QGraphicsTextItem::dragLeaveEvent(QGraphicsSceneDragDropEvent *event)
Reimplementa: QGraphicsItem::dragLeaveEvent(QGraphicsSceneDragDropEvent *event).
[override virtual protected] void QGraphicsTextItem::dragMoveEvent(QGraphicsSceneDragDropEvent *event)
Reimplementa: ` QGraphicsItem::dragMoveEvent(QGraphicsSceneDragDropEvent *event)`.
[override virtual protected] void QGraphicsTextItem::dropEvent(QGraphicsSceneDragDropEvent *event)
Reimplementa: QGraphicsItem::dropEvent(QGraphicsSceneDragDropEvent *event).
[override virtual protected] void QGraphicsTextItem::focusInEvent(QFocusEvent *event)
Reimplementa: QGraphicsItem::focusInEvent(QFocusEvent *event).
[override virtual protected] void QGraphicsTextItem::focusOutEvent(QFocusEvent *event)
Reimplementa: QGraphicsItem::focusOutEvent(QFocusEvent *event).
QFont QGraphicsTextItem::font() const
Devuelve la fuente del elemento, que se utiliza para mostrar el texto.
Véase también setFont().
[override virtual protected] void QGraphicsTextItem::hoverEnterEvent(QGraphicsSceneHoverEvent *event)
Reimplementa: ` QGraphicsItem::hoverEnterEvent(QGraphicsSceneHoverEvent *event)`.
[override virtual protected] void QGraphicsTextItem::hoverLeaveEvent(QGraphicsSceneHoverEvent *event)
Reimplementa: ` QGraphicsItem::hoverLeaveEvent(QGraphicsSceneHoverEvent *event)`.
[override virtual protected] void QGraphicsTextItem::hoverMoveEvent(QGraphicsSceneHoverEvent *event)
Reimplementa: QGraphicsItem::hoverMoveEvent(QGraphicsSceneHoverEvent *event).
[override virtual protected] void QGraphicsTextItem::inputMethodEvent(QInputMethodEvent *event)
Reimplementa: ` QGraphicsItem::inputMethodEvent(QInputMethodEvent *event)`.
[override virtual protected] QVariant QGraphicsTextItem::inputMethodQuery(Qt::InputMethodQuery query) const
Reimplementa: ` QGraphicsItem::inputMethodQuery` (conste `Qt::InputMethodQuery query`).
[override virtual] bool QGraphicsTextItem::isObscuredBy(const QGraphicsItem *item) const
Reimplementa: ` QGraphicsItem::isObscuredBy(const QGraphicsItem *item) const`.
[override virtual protected] void QGraphicsTextItem::keyPressEvent(QKeyEvent *event)
Reimplementa: QGraphicsItem::keyPressEvent(QKeyEvent *event).
[override virtual protected] void QGraphicsTextItem::keyReleaseEvent(QKeyEvent *event)
Reimplementa: ` QGraphicsItem::keyReleaseEvent(QKeyEvent *event)`.
[signal] void QGraphicsTextItem::linkActivated(const QString &link)
Esta señal se emite cuando el usuario hace clic en un enlace de un elemento de texto que da acceso a Qt::LinksAccessibleByMouse o Qt::LinksAccessibleByKeyboard. link es el enlace en el que se ha hecho clic.
Véase también setTextInteractionFlags().
[signal] void QGraphicsTextItem::linkHovered(const QString &link)
Esta señal se emite cuando el usuario pasa el cursor por encima de un enlace en un elemento de texto que activa Qt::LinksAccessibleByMouse. link es el enlace sobre el que se ha pasado el cursor.
Véase también setTextInteractionFlags().
[override virtual protected] void QGraphicsTextItem::mouseDoubleClickEvent(QGraphicsSceneMouseEvent *event)
Reimplementa: ` QGraphicsItem::mouseDoubleClickEvent(QGraphicsSceneMouseEvent *event)`.
[override virtual protected] void QGraphicsTextItem::mouseMoveEvent(QGraphicsSceneMouseEvent *event)
Reimplementa: ` QGraphicsItem::mouseMoveEvent(QGraphicsSceneMouseEvent *event)`.
[override virtual protected] void QGraphicsTextItem::mousePressEvent(QGraphicsSceneMouseEvent *event)
Reimplementa: ` QGraphicsItem::mousePressEvent(QGraphicsSceneMouseEvent *event)`.
[override virtual protected] void QGraphicsTextItem::mouseReleaseEvent(QGraphicsSceneMouseEvent *event)
Reimplementa: ` QGraphicsItem::mouseReleaseEvent(QGraphicsSceneMouseEvent *event)`.
[override virtual] QPainterPath QGraphicsTextItem::opaqueArea() const
Reimplementa: QGraphicsItem::opaqueArea() const.
[override virtual] void QGraphicsTextItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)
Reimplementa: ` QGraphicsItem::paint` (`QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)`.
[override virtual protected] bool QGraphicsTextItem::sceneEvent(QEvent *event)
Reimplementa: QGraphicsItem::sceneEvent(QEvent *event).
void QGraphicsTextItem::setDefaultTextColor(const QColor &col)
Establece el color del texto sin formato en col.
Véase también defaultTextColor().
void QGraphicsTextItem::setDocument(QTextDocument *document)
Establece el documento de texto « document » en el elemento.
Véase también document().
void QGraphicsTextItem::setFont(const QFont &font)
Establece la fuente utilizada para mostrar el elemento de texto en « font ».
Véase también font().
void QGraphicsTextItem::setHtml(const QString &text)
Establece el texto del elemento en text, dando por hecho que dicho texto tiene formato HTML. Si el elemento tiene el foco de entrada del teclado, esta función también llamará a ensureVisible() para garantizar que el texto sea visible en todas las ventanas gráficas.
Véase también toHtml(), hasFocus() y QGraphicsSimpleTextItem.
void QGraphicsTextItem::setPlainText(const QString &text)
Establece el texto del elemento en text. Si el elemento tiene el foco de entrada del teclado, esta función también llamará a ensureVisible() para garantizar que el texto sea visible en todas las ventanas gráficas.
Véanse también toHtml() y hasFocus().
void QGraphicsTextItem::setTabChangesFocus(bool b)
Si « b » es «true», la tecla « Tab » hará que el widget cambie de foco; en caso contrario, la tecla «tab» insertará una tabulación en el documento.
En algunas ocasiones, los campos de edición de texto no deben permitir al usuario introducir tabulaciones ni cambiar la sangría mediante la tecla Tab, ya que esto rompe la cadena de foco. El valor por defecto es «false».
Véase también tabChangesFocus(), ItemIsFocusable y textInteractionFlags().
void QGraphicsTextItem::setTextInteractionFlags(Qt::TextInteractionFlags flags)
Establece los indicadores « flags » para especificar cómo debe reaccionar el elemento de texto ante la entrada del usuario.
El valor predeterminado de « QGraphicsTextItem » es « Qt::NoTextInteraction ». Esta función también afecta al indicador «ItemIsFocusable» QGraphicsItem, activándolo si « flags » es distinto de « Qt::NoTextInteraction » y desactivándolo en caso contrario.
Por defecto, el texto es de solo lectura. Para convertir el elemento en un editor, establece el indicador Qt::TextEditable.
Véase también textInteractionFlags().
void QGraphicsTextItem::setTextWidth(qreal width)
Establece el ancho preferido para el texto del elemento. Si el texto real ocupa más ancho que el especificado, se dividirá en varias líneas.
Si se establece « width » en -1, el texto no se dividirá en varias líneas a menos que se imponga mediante un salto de línea explícito o un nuevo párrafo.
El valor por defecto es -1.
Ten en cuenta que ` QGraphicsTextItem ` mantiene internamente un ` QTextDocument `, que se utiliza para calcular el ancho del texto.
Véanse también textWidth() y QTextDocument::setTextWidth().
[override virtual] QPainterPath QGraphicsTextItem::shape() const
Reimplementa: ` QGraphicsItem::shape()` const.
bool QGraphicsTextItem::tabChangesFocus() const
Devuelve « true » si la clave « Tab » hace que el widget cambie de foco; en caso contrario, devuelve «false».
Por defecto, este comportamiento está desactivado y esta función devolverá false.
Véase también setTabChangesFocus().
Qt::TextInteractionFlags QGraphicsTextItem::textInteractionFlags() const
Devuelve los indicadores de interacción con el texto actuales.
Véase también setTextInteractionFlags().
qreal QGraphicsTextItem::textWidth() const
Devuelve la anchura del texto.
El ancho se calcula con el objeto ` QTextDocument ` que ` QGraphicsTextItem ` mantiene internamente.
Véase también setTextWidth() y QTextDocument::textWidth().
QString QGraphicsTextItem::toHtml() const
Devuelve el texto del elemento convertido a HTML, o un objeto ` QString ` vacío si no se ha establecido ningún texto.
Véase también setHtml().
QString QGraphicsTextItem::toPlainText() const
Devuelve el texto del elemento convertido a texto sin formato, o un objeto ` QString ` vacío si no se ha establecido ningún texto.
Véase también setPlainText().
[override virtual] int QGraphicsTextItem::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.