CopperSpice API  1.7.2
QGraphicsTextItem Class Reference

The QGraphicsTextItem class provides a text item that you can add to a QGraphicsScene to display formatted text. More...

Inheritance diagram for QGraphicsTextItem:
QGraphicsObject QObject QGraphicsItem

Public Signals

void linkActivated (const QString &link)
 
void linkHovered (const QString &link)
 
- Public Signals inherited from QGraphicsObject
void enabledChanged ()
 
void opacityChanged ()
 
void parentChanged ()
 
void rotationChanged ()
 
void scaleChanged ()
 
void visibleChanged ()
 
void xChanged ()
 
void yChanged ()
 
void zChanged ()
 
- Public Signals inherited from QObject
void destroyed (QObject *obj=nullptr)
 
void objectNameChanged (const QString &objectName)
 

Public Methods

 QGraphicsTextItem (const QString &text, QGraphicsItem *parent=nullptr)
 
 QGraphicsTextItem (QGraphicsItem *parent=nullptr)
 
 ~QGraphicsTextItem ()
 
void adjustSize ()
 
QRectF boundingRect () const override
 
bool contains (const QPointF &point) const override
 
QColor defaultTextColor () const
 
QTextDocumentdocument () const
 
QFont font () const
 
bool isObscuredBy (const QGraphicsItem *graphicsItem) const override
 
QPainterPath opaqueArea () const override
 
bool openExternalLinks () const
 
void paint (QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget) override
 
void setDefaultTextColor (const QColor &color)
 
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)
 
QPainterPath shape () const override
 
bool tabChangesFocus () const
 
QTextCursor textCursor () const
 
Qt::TextInteractionFlags textInteractionFlags () const
 
qreal textWidth () const
 
QString toHtml () const
 
QString toPlainText () const
 
int type () const override
 
- Public Methods inherited from QGraphicsObject
 QGraphicsObject (QGraphicsItem *parent=nullptr)
 
const QList< QObject * > & children () const
 
void grabGesture (Qt::GestureType gesture, Qt::GestureFlags flags=Qt::GestureFlags ())
 
void ungrabGesture (Qt::GestureType gesture)
 
- Public Methods inherited from QObject
 QObject (QObject *parent=nullptr)
 
 ~QObject ()
 
bool blockSignals (bool block)
 
const QList< QObject * > & children () const
 
bool connect (const QObject *sender, const QString &signalMethod, const QString &location, const QString &slotMethod, Qt::ConnectionType type=Qt::AutoConnection)
 
bool connect (const QObject *sender, const QString &signalMethod, const QString &slotMethod, Qt::ConnectionType type=Qt::AutoConnection)
 
bool disconnect (const QObject *receiver, const QString &slotMethod=QString ()) const
 
bool disconnect (const QString &signalMethod, const QString &location, const QObject *receiver=nullptr, const QString &slotMethod=QString ()) const
 
bool disconnect (const QString &signalMethod=QString (), const QObject *receiver=nullptr, const QString &slotMethod=QString ()) const
 
void dumpObjectInfo ()
 
void dumpObjectTree ()
 
QList< QStringdynamicPropertyNames () const
 
virtual bool event (QEvent *event)
 
virtual bool eventFilter (QObject *watched, QEvent *event)
 
template<typename T >
findChild (const QString &childName=QString ()) const
 
template<class T >
QList< T > findChildren (const QRegularExpression &regExp, Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
 
template<class T >
QList< T > findChildren (const QString &objName=QString (), Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
 
bool inherits (const QString &className) const
 
void installEventFilter (QObject *filterObj)
 
bool isWidgetType () const
 
bool isWindowType () const
 
void killTimer (int id)
 
const QMetaObjectmetaObject () const
 
void moveToThread (QThread *targetThread)
 
QString objectName () const
 
QObject * parent () const
 
template<class T = QVariant>
property (const QString &name) const
 
void removeEventFilter (QObject *obj)
 
void setObjectName (const QString &name)
 
void setParent (QObject *parent)
 
bool setProperty (const QString &name, const QVariant &value)
 
bool signalsBlocked () const
 
int startTimer (int interval, Qt::TimerType timerType=Qt::CoarseTimer)
 
QThreadthread () const
 
- Public Methods inherited from QGraphicsItem
 QGraphicsItem (QGraphicsItem *parent=nullptr)
 
virtual ~QGraphicsItem ()
 
bool acceptDrops () const
 
Qt::MouseButtons acceptedMouseButtons () const
 
bool acceptHoverEvents () const
 
bool acceptTouchEvents () const
 
virtual void advance (int phase)
 
QRegion boundingRegion (const QTransform &itemToDeviceTransform) const
 
qreal boundingRegionGranularity () const
 
CacheMode cacheMode () const
 
QList< QGraphicsItem * > childItems () const
 
QRectF childrenBoundingRect () const
 
void clearFocus ()
 
QPainterPath clipPath () const
 
virtual bool collidesWithItem (const QGraphicsItem *graphicsItem, Qt::ItemSelectionMode mode=Qt::IntersectsItemShape) const
 
virtual bool collidesWithPath (const QPainterPath &path, Qt::ItemSelectionMode mode=Qt::IntersectsItemShape) const
 
QList< QGraphicsItem * > collidingItems (Qt::ItemSelectionMode mode=Qt::IntersectsItemShape) const
 
QGraphicsItem * commonAncestorItem (const QGraphicsItem *graphicsItem) const
 
QCursor cursor () const
 
QVariant data (int key) const
 
QTransform deviceTransform (const QTransform &viewportTransform) const
 
qreal effectiveOpacity () const
 
void ensureVisible (const QRectF &rectF=QRectF (), int xmargin=50, int ymargin=50)
 
void ensureVisible (qreal x, qreal y, qreal width, qreal height, int xmargin=50, int ymargin=50)
 
bool filtersChildEvents () const
 
GraphicsItemFlags flags () const
 
QGraphicsItem * focusItem () const
 
QGraphicsItem * focusProxy () const
 
void grabKeyboard ()
 
void grabMouse ()
 
QGraphicsEffectgraphicsEffect () const
 
QGraphicsItemGroupgroup () const
 
bool handlesChildEvents () const
 
bool hasCursor () const
 
bool hasFocus () const
 
void hide ()
 
Qt::InputMethodHints inputMethodHints () const
 
void installSceneEventFilter (QGraphicsItem *filterItem)
 
bool isActive () const
 
bool isAncestorOf (const QGraphicsItem *graphicsItem) const
 
bool isBlockedByModalPanel (QGraphicsItem **blockingPanel=nullptr) const
 
bool isClipped () const
 
bool isEnabled () const
 
bool isObscured (const QRectF &rectF=QRectF ()) const
 
bool isObscured (qreal x, qreal y, qreal width, qreal height) const
 
bool isPanel () const
 
bool isSelected () const
 
bool isUnderMouse () const
 
bool isVisible () const
 
bool isVisibleTo (const QGraphicsItem *graphicsItem) const
 
bool isWidget () const
 
bool isWindow () const
 
QTransform itemTransform (const QGraphicsItem *graphicsItem, bool *ok=nullptr) const
 
QPainterPath mapFromItem (const QGraphicsItem *graphicsItem, const QPainterPath &path) const
 
QPointF mapFromItem (const QGraphicsItem *graphicsItem, const QPointF &point) const
 
QPolygonF mapFromItem (const QGraphicsItem *graphicsItem, const QPolygonF &polygon) const
 
QPolygonF mapFromItem (const QGraphicsItem *graphicsItem, const QRectF &rectF) const
 
QPointF mapFromItem (const QGraphicsItem *graphicsItem, qreal x, qreal y) const
 
QPolygonF mapFromItem (const QGraphicsItem *graphicsItem, qreal x, qreal y, qreal width, qreal height) const
 
QPainterPath mapFromParent (const QPainterPath &path) const
 
QPointF mapFromParent (const QPointF &point) const
 
QPolygonF mapFromParent (const QPolygonF &polygon) const
 
QPolygonF mapFromParent (const QRectF &rectF) const
 
QPointF mapFromParent (qreal x, qreal y) const
 
QPolygonF mapFromParent (qreal x, qreal y, qreal width, qreal height) const
 
QPainterPath mapFromScene (const QPainterPath &path) const
 
QPointF mapFromScene (const QPointF &point) const
 
QPolygonF mapFromScene (const QPolygonF &polygon) const
 
QPolygonF mapFromScene (const QRectF &rectF) const
 
QPointF mapFromScene (qreal x, qreal y) const
 
QPolygonF mapFromScene (qreal x, qreal y, qreal width, qreal height) const
 
QRectF mapRectFromItem (const QGraphicsItem *graphicsItem, const QRectF &rectF) const
 
QRectF mapRectFromItem (const QGraphicsItem *graphicsItem, qreal x, qreal y, qreal width, qreal height) const
 
QRectF mapRectFromParent (const QRectF &rectF) const
 
QRectF mapRectFromParent (qreal x, qreal y, qreal width, qreal height) const
 
QRectF mapRectFromScene (const QRectF &rectF) const
 
QRectF mapRectFromScene (qreal x, qreal y, qreal width, qreal height) const
 
QRectF mapRectToItem (const QGraphicsItem *graphicsItem, const QRectF &rectF) const
 
QRectF mapRectToItem (const QGraphicsItem *graphicsItem, qreal x, qreal y, qreal width, qreal height) const
 
QRectF mapRectToParent (const QRectF &rectF) const
 
QRectF mapRectToParent (qreal x, qreal y, qreal width, qreal height) const
 
QRectF mapRectToScene (const QRectF &rectF) const
 
QRectF mapRectToScene (qreal x, qreal y, qreal width, qreal height) const
 
QPainterPath mapToItem (const QGraphicsItem *graphicsItem, const QPainterPath &path) const
 
QPointF mapToItem (const QGraphicsItem *graphicsItem, const QPointF &point) const
 
QPolygonF mapToItem (const QGraphicsItem *graphicsItem, const QPolygonF &polygon) const
 
QPolygonF mapToItem (const QGraphicsItem *graphicsItem, const QRectF &rectF) const
 
QPointF mapToItem (const QGraphicsItem *graphicsItem, qreal x, qreal y) const
 
QPolygonF mapToItem (const QGraphicsItem *graphicsItem, qreal x, qreal y, qreal width, qreal height) const
 
QPainterPath mapToParent (const QPainterPath &path) const
 
QPointF mapToParent (const QPointF &point) const
 
QPolygonF mapToParent (const QPolygonF &polygon) const
 
QPolygonF mapToParent (const QRectF &rectF) const
 
QPointF mapToParent (qreal x, qreal y) const
 
QPolygonF mapToParent (qreal x, qreal y, qreal width, qreal height) const
 
QPainterPath mapToScene (const QPainterPath &path) const
 
QPointF mapToScene (const QPointF &point) const
 
QPolygonF mapToScene (const QPolygonF &polygon) const
 
QPolygonF mapToScene (const QRectF &rectF) const
 
QPointF mapToScene (qreal x, qreal y) const
 
QPolygonF mapToScene (qreal x, qreal y, qreal width, qreal height) const
 
QMatrix matrix () const
 
void moveBy (qreal dx, qreal dy)
 
qreal opacity () const
 
QGraphicsItem * panel () const
 
PanelModality panelModality () const
 
QGraphicsItem * parentItem () const
 
QGraphicsObjectparentObject () const
 
QGraphicsWidgetparentWidget () const
 
QPointF pos () const
 
void removeSceneEventFilter (QGraphicsItem *filterItem)
 
void resetMatrix ()
 
void resetTransform ()
 
qreal rotation () const
 
qreal scale () const
 
QGraphicsScenescene () const
 
QRectF sceneBoundingRect () const
 
QMatrix sceneMatrix () const
 
QPointF scenePos () const
 
QTransform sceneTransform () const
 
void scroll (qreal dx, qreal dy, const QRectF &rectF=QRectF ())
 
void setAcceptDrops (bool on)
 
void setAcceptedMouseButtons (Qt::MouseButtons buttons)
 
void setAcceptHoverEvents (bool enabled)
 
void setAcceptTouchEvents (bool enabled)
 
void setActive (bool active)
 
void setBoundingRegionGranularity (qreal granularity)
 
void setCacheMode (CacheMode mode, const QSize &cacheSize=QSize ())
 
void setCursor (const QCursor &cursor)
 
void setData (int key, const QVariant &value)
 
void setEnabled (bool enabled)
 
void setFiltersChildEvents (bool enabled)
 
void setFlag (GraphicsItemFlag flag, bool enabled=true)
 
void setFlags (GraphicsItemFlags flags)
 
void setFocus (Qt::FocusReason focusReason=Qt::OtherFocusReason)
 
void setFocusProxy (QGraphicsItem *graphicsItem)
 
void setGraphicsEffect (QGraphicsEffect *effect)
 
void setGroup (QGraphicsItemGroup *group)
 
void setHandlesChildEvents (bool enabled)
 
void setInputMethodHints (Qt::InputMethodHints hints)
 
void setMatrix (const QMatrix &matrix, bool combine=false)
 
void setOpacity (qreal opacity)
 
void setPanelModality (PanelModality panelModality)
 
void setParentItem (QGraphicsItem *parent)
 
void setPos (const QPointF &pos)
 
void setPos (qreal x, qreal y)
 
void setRotation (qreal angle)
 
void setScale (qreal factor)
 
void setSelected (bool selected)
 
void setToolTip (const QString &toolTip)
 
void setTransform (const QTransform &matrix, bool combine=false)
 
void setTransformations (const QList< QGraphicsTransform * > &transformations)
 
void setTransformOriginPoint (const QPointF &origin)
 
void setTransformOriginPoint (qreal x, qreal y)
 
void setVisible (bool visible)
 
void setX (qreal x)
 
void setY (qreal y)
 
void setZValue (qreal z)
 
void show ()
 
void stackBefore (const QGraphicsItem *graphicsItem)
 
QGraphicsObjecttoGraphicsObject ()
 
const QGraphicsObjecttoGraphicsObject () const
 
QString toolTip () const
 
QGraphicsItem * topLevelItem () const
 
QGraphicsWidgettopLevelWidget () const
 
QTransform transform () const
 
QList< QGraphicsTransform * > transformations () const
 
QPointF transformOriginPoint () const
 
void ungrabKeyboard ()
 
void ungrabMouse ()
 
void unsetCursor ()
 
void update (const QRectF &rectF=QRectF ())
 
void update (qreal x, qreal y, qreal width, qreal height)
 
QGraphicsWidgetwindow () const
 
qreal x () const
 
qreal y () const
 
qreal zValue () const
 

Protected Methods

void contextMenuEvent (QGraphicsSceneContextMenuEvent *event) override
 
void dragEnterEvent (QGraphicsSceneDragDropEvent *event) override
 
void dragLeaveEvent (QGraphicsSceneDragDropEvent *event) override
 
void dragMoveEvent (QGraphicsSceneDragDropEvent *event) override
 
void dropEvent (QGraphicsSceneDragDropEvent *event) override
 
void focusInEvent (QFocusEvent *event) override
 
void focusOutEvent (QFocusEvent *event) override
 
void hoverEnterEvent (QGraphicsSceneHoverEvent *event) override
 
void hoverLeaveEvent (QGraphicsSceneHoverEvent *event) override
 
void hoverMoveEvent (QGraphicsSceneHoverEvent *event) override
 
void inputMethodEvent (QInputMethodEvent *event) override
 
QVariant inputMethodQuery (Qt::InputMethodQuery query) const override
 
void keyPressEvent (QKeyEvent *event) override
 
void keyReleaseEvent (QKeyEvent *event) override
 
void mouseDoubleClickEvent (QGraphicsSceneMouseEvent *event) override
 
void mouseMoveEvent (QGraphicsSceneMouseEvent *event) override
 
void mousePressEvent (QGraphicsSceneMouseEvent *event) override
 
void mouseReleaseEvent (QGraphicsSceneMouseEvent *event) override
 
bool sceneEvent (QEvent *event) override
 
- Protected Methods inherited from QObject
virtual void childEvent (QChildEvent *event)
 
virtual void connectNotify (const QMetaMethod &signalMethod) const
 
virtual void customEvent (QEvent *event)
 
virtual void disconnectNotify (const QMetaMethod &signalMethod) const
 
bool isSignalConnected (const QMetaMethod &signalMethod) const
 
int receivers (const QString &signal) const
 
QObject * sender () const
 
int senderSignalIndex () const
 
virtual void timerEvent (QTimerEvent *event)
 
- Protected Methods inherited from QGraphicsItem
virtual QVariant itemChange (GraphicsItemChange change, const QVariant &value)
 
void prepareGeometryChange ()
 
virtual bool sceneEventFilter (QGraphicsItem *watched, QEvent *event)
 
void updateMicroFocus ()
 
virtual void wheelEvent (QGraphicsSceneWheelEvent *event)
 

Properties

 openExternalLinks
 
 textCursor
 
- Properties inherited from QGraphicsObject
 effect
 
 enabled
 
 opacity
 
 parent
 
 pos
 
 rotation
 
 scale
 
 transformOriginPoint
 
 visible
 
 x
 
 y
 
 z
 
- Properties inherited from QObject
 objectName
 

Additional Inherited Members

- Public Typedefs inherited from QGraphicsItem
using GraphicsItemFlags = QFlags< GraphicsItemFlag >
 
- Public Types inherited from QGraphicsItem
enum  CacheMode
 
enum  GraphicsItemChange
 
enum  GraphicsItemFlag
 
enum  PanelModality
 
- Public Slots inherited from QObject
void deleteLater ()
 
- Static Public Methods inherited from QObject
static bool connect (const QObject *sender, const QMetaMethod &signalMethod, const QObject *receiver, const QMetaMethod &slotMethod, Qt::ConnectionType type=Qt::AutoConnection)
 
static bool connect (const QObject *sender, const QString &signalMethod, const QObject *receiver, const QString &slotMethod, Qt::ConnectionType type=Qt::AutoConnection, const QString &location=QString ())
 
static bool connect (const QObject *sender, const QString &signalMethod, const QString &location, const QObject *receiver, const QString &slotMethod, Qt::ConnectionType type=Qt::AutoConnection)
 
template<class Sender , class SignalClass , class... SignalArgs, class Receiver , class SlotClass , class... SlotArgs, class SlotReturn >
static bool connect (const Sender *sender, void (SignalClass::*signalMethod)(SignalArgs...), const Receiver *receiver, SlotReturn (SlotClass::*slotMethod)(SlotArgs...), Qt::ConnectionType type=Qt::AutoConnection)
 
template<class Sender , class SignalClass , class... SignalArgs, class Receiver , class T >
static bool connect (const Sender *sender, void (SignalClass::*signalMethod)(SignalArgs...), const Receiver *receiver, T slotLambda, Qt::ConnectionType type=Qt::AutoConnection)
 
static bool disconnect (const QObject *sender, const QMetaMethod &signalMethod, const QObject *receiver, const QMetaMethod &slotMethod)
 
static bool disconnect (const QObject *sender, const QString &signalMethod, const QObject *receiver, const QString &slotMethod)
 
static bool disconnect (const QObject *sender, const QString &signalMethod, const QString &location, const QObject *receiver, const QString &slotMethod)
 
template<class Sender , class SignalClass , class... SignalArgs, class Receiver , class SlotClass , class... SlotArgs, class SlotReturn >
static bool disconnect (const Sender *sender, void (SignalClass::*signalMethod)(SignalArgs...), const Receiver *receiver, SlotReturn (SlotClass::*slotMethod)(SlotArgs...))
 
template<class Sender , class SignalClass , class... SignalArgs, class Receiver >
static bool disconnect (const Sender *sender, void (SignalClass::*signalMethod)(SignalArgs...), const Receiver *receiver, std::nullptr_t slotMethod=nullptr)
 
template<class Sender , class SignalClass , class... SignalArgs, class Receiver , class T >
static bool disconnect (const Sender *sender, void (SignalClass::*signalMethod)(SignalArgs...), const Receiver *receiver, T slotMethod)
 
static QMetaObjectstaticMetaObject ()
 
static QString tr (const char *text, const char *comment=nullptr, std::optional< int > numArg=std::optional< int >())
 
- Protected Slots inherited from QGraphicsObject
void updateMicroFocus ()
 

Detailed Description

The QGraphicsTextItem class provides a text item that you can add to a QGraphicsScene to display formatted text.

If you only need to show plain text in an item, consider using QGraphicsSimpleTextItem instead.

To set the item's text, pass a QString to QGraphicsTextItem's constructor, or call setHtml()/setPlainText().

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

It is possible to make the item editable by setting the Qt::TextEditorInteraction flag using setTextInteractionFlags().

The item's preferred text width can be set using setTextWidth() and obtained using textWidth().

Note
In order to align HTML text in the center, the item's text width must be set.
Note
QGraphicsTextItem accepts hover events by default. You can change this with setAcceptHoverEvents().
See also
QGraphicsSimpleTextItem, QGraphicsPathItem, QGraphicsRectItem, QGraphicsEllipseItem, QGraphicsPixmapItem, QGraphicsPolygonItem, QGraphicsLineItem, Graphics View System

Constructor & Destructor Documentation

QGraphicsTextItem::QGraphicsTextItem ( QGraphicsItem parent = nullptr)
explicit

Constructs a QGraphicsTextItem. The parent is passed to QGraphicsItem's constructor.

See also
QGraphicsScene::addItem()
QGraphicsTextItem::QGraphicsTextItem ( const QString text,
QGraphicsItem parent = nullptr 
)
explicit

Constructs a QGraphicsTextItem, using text as the default plain text. The parent is passed to QGraphicsItem's constructor.

See also
QGraphicsScene::addItem()
QGraphicsTextItem::~QGraphicsTextItem ( )

Destroys the QGraphicsTextItem.

Method Documentation

void QGraphicsTextItem::adjustSize ( )

Adjusts the text item to a reasonable size.

QRectF QGraphicsTextItem::boundingRect ( ) const
overridevirtual

Reimplemented from QGraphicsItem::boundingRect().

Implements QGraphicsItem.

bool QGraphicsTextItem::contains ( const QPointF point) const
overridevirtual

Reimplemented from QGraphicsItem::contains().

Reimplemented from QGraphicsItem.

void QGraphicsTextItem::contextMenuEvent ( QGraphicsSceneContextMenuEvent event)
overrideprotectedvirtual

Reimplemented from QGraphicsItem::contextMenuEvent().

Reimplemented from QGraphicsItem.

QColor QGraphicsTextItem::defaultTextColor ( ) const

Returns the default text color that is used to for unformatted text.

See also
setDefaultTextColor()
QTextDocument * QGraphicsTextItem::document ( ) const

Returns the item's text document.

See also
setDocument()
void QGraphicsTextItem::dragEnterEvent ( QGraphicsSceneDragDropEvent event)
overrideprotectedvirtual

Reimplemented from QGraphicsItem::dragEnterEvent().

Reimplemented from QGraphicsItem.

void QGraphicsTextItem::dragLeaveEvent ( QGraphicsSceneDragDropEvent event)
overrideprotectedvirtual

Reimplemented from QGraphicsItem::dragLeaveEvent().

Reimplemented from QGraphicsItem.

void QGraphicsTextItem::dragMoveEvent ( QGraphicsSceneDragDropEvent event)
overrideprotectedvirtual

Reimplemented from QGraphicsItem::dragMoveEvent().

Reimplemented from QGraphicsItem.

void QGraphicsTextItem::dropEvent ( QGraphicsSceneDragDropEvent event)
overrideprotectedvirtual

Reimplemented from QGraphicsItem::dropEvent().

Reimplemented from QGraphicsItem.

void QGraphicsTextItem::focusInEvent ( QFocusEvent event)
overrideprotectedvirtual

Reimplemented from QGraphicsItem::focusInEvent().

Reimplemented from QGraphicsItem.

void QGraphicsTextItem::focusOutEvent ( QFocusEvent event)
overrideprotectedvirtual

Reimplemented from QGraphicsItem::focusOutEvent().

Reimplemented from QGraphicsItem.

QFont QGraphicsTextItem::font ( ) const

Returns the item's font, which is used to render the text.

See also
setFont()
void QGraphicsTextItem::hoverEnterEvent ( QGraphicsSceneHoverEvent event)
overrideprotectedvirtual

Reimplemented from QGraphicsItem::hoverEnterEvent().

Reimplemented from QGraphicsItem.

void QGraphicsTextItem::hoverLeaveEvent ( QGraphicsSceneHoverEvent event)
overrideprotectedvirtual

Reimplemented from QGraphicsItem::hoverLeaveEvent().

Reimplemented from QGraphicsItem.

void QGraphicsTextItem::hoverMoveEvent ( QGraphicsSceneHoverEvent event)
overrideprotectedvirtual

Reimplemented from QGraphicsItem::hoverMoveEvent().

Reimplemented from QGraphicsItem.

void QGraphicsTextItem::inputMethodEvent ( QInputMethodEvent event)
overrideprotectedvirtual

Reimplemented from QGraphicsItem::inputMethodEvent().

Reimplemented from QGraphicsItem.

QVariant QGraphicsTextItem::inputMethodQuery ( Qt::InputMethodQuery  query) const
overrideprotectedvirtual

Reimplemented from QGraphicsItem::inputMethodQuery().

Reimplemented from QGraphicsItem.

bool QGraphicsTextItem::isObscuredBy ( const QGraphicsItem graphicsItem) const
overridevirtual

Reimplemented from QGraphicsItem::isObscuredBy().

Reimplemented from QGraphicsItem.

void QGraphicsTextItem::keyPressEvent ( QKeyEvent event)
overrideprotectedvirtual

Reimplemented from QGraphicsItem::keyPressEvent().

Reimplemented from QGraphicsItem.

void QGraphicsTextItem::keyReleaseEvent ( QKeyEvent event)
overrideprotectedvirtual

Reimplemented from QGraphicsItem::keyReleaseEvent().

Reimplemented from QGraphicsItem.

void QGraphicsTextItem::linkActivated ( const QString link)
signal

This signal is emitted when the user clicks on a link on a text item that enables Qt::LinksAccessibleByMouse or Qt::LinksAccessibleByKeyboard. link is the link that was clicked.

See also
setTextInteractionFlags()
void QGraphicsTextItem::linkHovered ( const QString link)
signal

This signal is emitted when the user hovers over a link on a text item that enables Qt::LinksAccessibleByMouse. link is the link that was hovered over.

See also
setTextInteractionFlags()
void QGraphicsTextItem::mouseDoubleClickEvent ( QGraphicsSceneMouseEvent event)
overrideprotectedvirtual

Reimplemented from QGraphicsItem::mouseDoubleClickEvent().

Reimplemented from QGraphicsItem.

void QGraphicsTextItem::mouseMoveEvent ( QGraphicsSceneMouseEvent event)
overrideprotectedvirtual

Reimplemented from QGraphicsItem::mouseMoveEvent().

Reimplemented from QGraphicsItem.

void QGraphicsTextItem::mousePressEvent ( QGraphicsSceneMouseEvent event)
overrideprotectedvirtual

Reimplemented from QGraphicsItem::mousePressEvent().

Reimplemented from QGraphicsItem.

void QGraphicsTextItem::mouseReleaseEvent ( QGraphicsSceneMouseEvent event)
overrideprotectedvirtual

Reimplemented from QGraphicsItem::mouseReleaseEvent().

Reimplemented from QGraphicsItem.

QPainterPath QGraphicsTextItem::opaqueArea ( ) const
overridevirtual

Reimplemented from QGraphicsItem::opaqueArea().

Reimplemented from QGraphicsItem.

bool QGraphicsTextItem::openExternalLinks ( ) const

Property documentation pending.

void QGraphicsTextItem::paint ( QPainter painter,
const QStyleOptionGraphicsItem option,
QWidget widget 
)
overridevirtual

Reimplemented from QGraphicsItem::paint().

Implements QGraphicsItem.

bool QGraphicsTextItem::sceneEvent ( QEvent event)
overrideprotectedvirtual

Reimplemented from QGraphicsItem::sceneEvent().

Reimplemented from QGraphicsItem.

void QGraphicsTextItem::setDefaultTextColor ( const QColor color)

Sets the color for unformatted text to col.

See also
defaultTextColor()
void QGraphicsTextItem::setDocument ( QTextDocument document)

Sets the text document document on the item.

See also
document()
void QGraphicsTextItem::setFont ( const QFont font)

Sets the font used to render the text item to font.

See also
font()
void QGraphicsTextItem::setHtml ( const QString text)

Sets the item's text to text, assuming that text is HTML formatted. If the item has keyboard input focus, this function will also call ensureVisible() to ensure that the text is visible in all viewports.

See also
toHtml(), hasFocus(), QGraphicsSimpleTextItem
void QGraphicsTextItem::setOpenExternalLinks ( bool  open)

Property documentation pending.

void QGraphicsTextItem::setPlainText ( const QString text)

Sets the item's text to text. If the item has keyboard input focus, this function will also call ensureVisible() to ensure that the text is visible in all viewports.

See also
toHtml(), hasFocus()
void QGraphicsTextItem::setTabChangesFocus ( bool  b)

If b is true, the Tab key will cause the widget to change focus, otherwise the tab key will insert a tab into the document.

In some occasions text edits should not allow the user to input tabulators or change indentation using the Tab key, as this breaks the focus chain. The default is false.

See also
tabChangesFocus(), ItemIsFocusable, textInteractionFlags()
void QGraphicsTextItem::setTextCursor ( const QTextCursor cursor)

Property documentation pending.

void QGraphicsTextItem::setTextInteractionFlags ( Qt::TextInteractionFlags  flags)

Sets the flags flags to specify how the text item should react to user input.

The default for a QGraphicsTextItem is Qt::NoTextInteraction. This function also affects the ItemIsFocusable QGraphicsItem flag by setting it if flags is different from Qt::NoTextInteraction and clearing it otherwise.

By default, the text is read-only. To transform the item into an editor, set the Qt::TextEditable flag.

See also
textInteractionFlags()
void QGraphicsTextItem::setTextWidth ( qreal  width)

Sets the preferred width for the item's text. If the actual text is wider than the specified width then it will be broken into multiple lines.

If width is set to -1 then the text will not be broken into multiple lines unless it is enforced through an explicit line break or a new paragraph.

The default value is -1.

Note that QGraphicsTextItem keeps a QTextDocument internally, which is used to calculate the text width.

See also
textWidth(), QTextDocument::setTextWidth()
QPainterPath QGraphicsTextItem::shape ( ) const
overridevirtual

Reimplemented from QGraphicsItem::shape().

Reimplemented from QGraphicsItem.

bool QGraphicsTextItem::tabChangesFocus ( ) const

Returns true if the Tab key will cause the widget to change focus, otherwise false is returned.

By default, this behavior is disabled, and this function will return false.

See also
setTabChangesFocus()
QTextCursor QGraphicsTextItem::textCursor ( ) const

Property documentation pending.

Qt::TextInteractionFlags QGraphicsTextItem::textInteractionFlags ( ) const

Returns the current text interaction flags.

See also
setTextInteractionFlags()
qreal QGraphicsTextItem::textWidth ( ) const

Returns the text width.

The width is calculated with the QTextDocument that QGraphicsTextItem keeps internally.

See also
setTextWidth(), QTextDocument::textWidth()
QString QGraphicsTextItem::toHtml ( ) const

Returns the item's text converted to HTML, or an empty QString if no text has been set.

See also
setHtml()
QString QGraphicsTextItem::toPlainText ( ) const

Returns the item's text converted to plain text, or an empty QString if no text has been set.

See also
setPlainText()
int QGraphicsTextItem::type ( ) const
overridevirtual

Reimplemented from QGraphicsItem::type().

Reimplemented from QGraphicsItem.

Property Documentation

QGraphicsTextItem::openExternalLinks

Specifies whether QGraphicsTextItem should automatically open links using QDesktopServices::openUrl() instead of emitting the linkActivated signal.

The default value is false.

PropertiesClass Methods
read openExternalLinks
write setOpenExternalLinks
QGraphicsTextItem::textCursor

This property represents the visible text cursor in an editable text item.

By default, if the item's text has not been set, this property contains a null text cursor, otherwise it contains a text cursor placed at the start of the item's document.

PropertiesClass Methods
read textCursor
write setTextCursor