The QGraphicsTextItem class provides a text item which can be added to a QGraphicsScene to display formatted text. More...

Inheritance diagram for QGraphicsTextItem:

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

QTextDocument *	document () 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< QString >	dynamicPropertyNames () const

virtual bool	event (QEvent *event)

virtual bool	eventFilter (QObject watched, QEvent event)

template<typename T >
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 &childName=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 QMetaObject *	metaObject () const

void	moveToThread (QThread *targetThread)

QString	objectName () const

QObject *	parent () const

template<class T = QVariant>
T	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)

QThread *	thread () 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 ()

QGraphicsEffect *	graphicsEffect () const

QGraphicsItemGroup *	group () 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

QGraphicsObject *	parentObject () const

QGraphicsWidget *	parentWidget () const

QPointF	pos () const

void	removeSceneEventFilter (QGraphicsItem *filterItem)

void	resetMatrix ()

void	resetTransform ()

qreal	rotation () const

qreal	scale () const

QGraphicsScene *	scene () 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)

QGraphicsObject *	toGraphicsObject ()

const QGraphicsObject *	toGraphicsObject () const

QString	toolTip () const

QGraphicsItem *	topLevelItem () const

QGraphicsWidget *	topLevelWidget () 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)

QGraphicsWidget *	window () 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 QGraphicsObject
bool	event (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)

static bool	disconnect (const QObject sender, std::nullptr_t, const QObject receiver, std::nullptr_t)

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 QMetaObject &	staticMetaObject ()

static QString	tr (const char text, const char comment=nullptr, std::optional< int > numArg=std::optional< int >())

Static Public Members inherited from QGraphicsItem
static constexpr const int	UserType = 65536

Protected Slots inherited from QGraphicsObject
void	updateMicroFocus ()

Related Functions inherited from QObject
T	qobject_cast (QObject *object)

	QObjectList

Related Functions inherited from QGraphicsItem
T	qgraphicsitem_cast (QGraphicsItem *item)

Detailed Description

The QGraphicsTextItem class provides a text item which can be added 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 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.; 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 object is passed to the QGraphicsItem 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 object is passed to the QGraphicsItem 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

Implements QGraphicsItem::boundingRect()

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

overridevirtual

Reimplemented from QGraphicsItem::contains()

void QGraphicsTextItem::contextMenuEvent ( QGraphicsSceneContextMenuEvent * event )

overrideprotectedvirtual

Reimplemented from QGraphicsItem::contextMenuEvent()

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

void QGraphicsTextItem::dragLeaveEvent ( QGraphicsSceneDragDropEvent * event )

overrideprotectedvirtual

Reimplemented from QGraphicsItem::dragLeaveEvent()

void QGraphicsTextItem::dragMoveEvent ( QGraphicsSceneDragDropEvent * event )

overrideprotectedvirtual

Reimplemented from QGraphicsItem::dragMoveEvent()

void QGraphicsTextItem::dropEvent ( QGraphicsSceneDragDropEvent * event )

overrideprotectedvirtual

Reimplemented from QGraphicsItem::dropEvent()

void QGraphicsTextItem::focusInEvent ( QFocusEvent * event )

overrideprotectedvirtual

Reimplemented from QGraphicsItem::focusInEvent()

void QGraphicsTextItem::focusOutEvent ( QFocusEvent * event )

overrideprotectedvirtual

Reimplemented from QGraphicsItem::focusOutEvent()

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

void QGraphicsTextItem::hoverLeaveEvent ( QGraphicsSceneHoverEvent * event )

overrideprotectedvirtual

Reimplemented from QGraphicsItem::hoverLeaveEvent()

void QGraphicsTextItem::hoverMoveEvent ( QGraphicsSceneHoverEvent * event )

overrideprotectedvirtual

Reimplemented from QGraphicsItem::hoverMoveEvent()

void QGraphicsTextItem::inputMethodEvent ( QInputMethodEvent * event )

overrideprotectedvirtual

Reimplemented from QGraphicsItem::inputMethodEvent()

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

overrideprotectedvirtual

Reimplemented from QGraphicsItem::inputMethodQuery()

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

overridevirtual

Reimplemented from QGraphicsItem::isObscuredBy()

void QGraphicsTextItem::keyPressEvent ( QKeyEvent * event )

overrideprotectedvirtual

Reimplemented from QGraphicsItem::keyPressEvent()

void QGraphicsTextItem::keyReleaseEvent ( QKeyEvent * event )

overrideprotectedvirtual

Reimplemented from QGraphicsItem::keyReleaseEvent()

void QGraphicsTextItem::linkActivated ( const QString & link )

signal

This signal is emitted when the user clicks on the given link in a text item. The text item must have the flag Qt::LinksAccessibleByMouse or Qt::LinksAccessibleByKeyboard enabled.

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

void QGraphicsTextItem::mouseMoveEvent ( QGraphicsSceneMouseEvent * event )

overrideprotectedvirtual

Reimplemented from QGraphicsItem::mouseMoveEvent()

void QGraphicsTextItem::mousePressEvent ( QGraphicsSceneMouseEvent * event )

overrideprotectedvirtual

Reimplemented from QGraphicsItem::mousePressEvent()

void QGraphicsTextItem::mouseReleaseEvent ( QGraphicsSceneMouseEvent * event )

overrideprotectedvirtual

Reimplemented from QGraphicsItem::mouseReleaseEvent()

QPainterPath QGraphicsTextItem::opaqueArea ( ) const

overridevirtual

Reimplemented from QGraphicsItem::opaqueArea()

bool QGraphicsTextItem::openExternalLinks ( ) const

Returns the value of the openExternalLinks property.

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

overridevirtual

Implements QGraphicsItem::paint()

bool QGraphicsTextItem::sceneEvent ( QEvent * event )

overrideprotectedvirtual

Reimplemented from QGraphicsItem::sceneEvent()

void QGraphicsTextItem::setDefaultTextColor ( const QColor & color )

Sets the color for unformatted text to col.

See also: defaultTextColor()

void QGraphicsTextItem::setDocument ( QTextDocument * document )

Sets the value of the property to document.

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 )

Sets the value of the property to open.

void QGraphicsTextItem::setPlainText ( const QString & text )

Sets the item's text to text. If the item has keyboard input focus, this method 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(), textInteractionFlags(), QGraphicsItem::GraphicsItemFlag

void QGraphicsTextItem::setTextCursor ( const QTextCursor & cursor )

Sets the value of the property to cursor.

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

Sets the flags to specify how the text item should react to user input. The default for a QGraphicsTextItem is Qt::NoTextInteraction. This method also affects the QGraphicsItem::ItemIsFocusable 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(), QGraphicsItem::GraphicsItemFlag

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

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

Returns the value of the textCursor property.

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

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.

Properties	Class 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.

Properties	Class Methods
read	textCursor
write	setTextCursor

Public Signals

Public Methods

Protected Methods

Properties

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Method Documentation

Property Documentation