内容

• 公共类型
• 特性
• 公共函数
• 重实现公共函数
• 信号
• 重实现保护函数
• 详细描述

QGraphicsTextItem 类

QGraphicsTextItem 类提供的文本项可以被添加到 QGraphicsScene 以显示格式化文本。 更多...

头：	#include <QGraphicsTextItem>
CMake:	find_package(Qt6 COMPONENTS Widgets REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake:	QT += widgets
继承：	QGraphicsObject

• 所有成员列表，包括继承成员

公共类型

enum	anonymous { Type }

特性

• openExternalLinks : bool
• textCursor : QTextCursor

公共函数

	QGraphicsTextItem (const QString & text , QGraphicsItem * parent = nullptr)
	QGraphicsTextItem (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

重实现公共函数

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

信号

void	linkActivated (const QString & link )
void	linkHovered (const QString & link )

重实现保护函数

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

详细描述

若只需要在项中展示纯文本，考虑使用 QGraphicsSimpleTextItem 代替。

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 ()，和 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 ().

注意： In order to align HTML text in the center, the item's text width must be set. Otherwise, you can call adjustSize () after setting the item's text.

注意： QGraphicsTextItem accepts 悬停事件 by default. You can change this with setAcceptHoverEvents() .

另请参阅 QGraphicsSimpleTextItem , QGraphicsPathItem , QGraphicsRectItem , QGraphicsEllipseItem , QGraphicsPixmapItem , QGraphicsPolygonItem , QGraphicsLineItem ，和 图形视图框架 .

成员类型文档编制

enum QGraphicsTextItem:: anonymous

值的返回通过虚拟 type () 函数。

常量	值	描述
QGraphicsTextItem::Type	8	A graphics text item

特性文档编制

openExternalLinks : bool

指定是否 QGraphicsTextItem 应自动打开链接使用 QDesktopServices::openUrl () 而不是发射 linkActivated 信号。

默认值为 false。

访问函数：

bool	openExternalLinks () const
void	setOpenExternalLinks (bool open )

textCursor : QTextCursor

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.

访问函数：

QTextCursor	textCursor () const
void	setTextCursor (const QTextCursor & cursor )

成员函数文档编制

QGraphicsTextItem:: QGraphicsTextItem (const QString & text , QGraphicsItem * parent = nullptr)

Constructs a QGraphicsTextItem, using text 作为默认纯文本。 parent 会被传递给 QGraphicsItem 的构造函数。

另请参阅 QGraphicsScene::addItem ().

QGraphicsTextItem:: QGraphicsTextItem ( QGraphicsItem * parent = nullptr)

Constructs a QGraphicsTextItem. parent 会被传递给 QGraphicsItem 的构造函数。

另请参阅 QGraphicsScene::addItem ().

[signal] void QGraphicsTextItem:: linkActivated (const QString & link )

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.

另请参阅 setTextInteractionFlags ().

[signal] void QGraphicsTextItem:: linkHovered (const QString & link )

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.

另请参阅 setTextInteractionFlags ().

[虚拟] QGraphicsTextItem:: ~QGraphicsTextItem ()

销毁 QGraphicsTextItem .

void QGraphicsTextItem:: adjustSize ()

Adjusts the text item to a reasonable size.

[override virtual] QRectF QGraphicsTextItem:: boundingRect () const

重实现： QGraphicsItem::boundingRect () const.

[override virtual] bool QGraphicsTextItem:: contains (const QPointF & point ) const

重实现： QGraphicsItem::contains (const QPointF &point) const.

[override virtual protected] void QGraphicsTextItem:: contextMenuEvent ( QGraphicsSceneContextMenuEvent * event )

重实现： QGraphicsItem::contextMenuEvent (QGraphicsSceneContextMenuEvent *event).

QColor QGraphicsTextItem:: defaultTextColor () const

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

另请参阅 setDefaultTextColor ().

QTextDocument *QGraphicsTextItem:: document () const

返回项的文本文档。

另请参阅 setDocument ().

[override virtual protected] void QGraphicsTextItem:: dragEnterEvent ( QGraphicsSceneDragDropEvent * event )

重实现： QGraphicsItem::dragEnterEvent (QGraphicsSceneDragDropEvent *event).

[override virtual protected] void QGraphicsTextItem:: dragLeaveEvent ( QGraphicsSceneDragDropEvent * event )

重实现： QGraphicsItem::dragLeaveEvent (QGraphicsSceneDragDropEvent *event).

[override virtual protected] void QGraphicsTextItem:: dragMoveEvent ( QGraphicsSceneDragDropEvent * event )

重实现： QGraphicsItem::dragMoveEvent (QGraphicsSceneDragDropEvent *event).

[override virtual protected] void QGraphicsTextItem:: dropEvent ( QGraphicsSceneDragDropEvent * event )

重实现： QGraphicsItem::dropEvent (QGraphicsSceneDragDropEvent *event).

[override virtual protected] void QGraphicsTextItem:: focusInEvent ( QFocusEvent * event )

重实现： QGraphicsItem::focusInEvent (QFocusEvent *event).

[override virtual protected] void QGraphicsTextItem:: focusOutEvent ( QFocusEvent * event )

重实现： QGraphicsItem::focusOutEvent (QFocusEvent *event).

QFont QGraphicsTextItem:: font () const

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

另请参阅 setFont ().

[override virtual protected] void QGraphicsTextItem:: hoverEnterEvent ( QGraphicsSceneHoverEvent * event )

重实现： QGraphicsItem::hoverEnterEvent (QGraphicsSceneHoverEvent *event).

[override virtual protected] void QGraphicsTextItem:: hoverLeaveEvent ( QGraphicsSceneHoverEvent * event )

重实现： QGraphicsItem::hoverLeaveEvent (QGraphicsSceneHoverEvent *event).

[override virtual protected] void QGraphicsTextItem:: hoverMoveEvent ( QGraphicsSceneHoverEvent * event )

重实现： QGraphicsItem::hoverMoveEvent (QGraphicsSceneHoverEvent *event).

[override virtual protected] void QGraphicsTextItem:: inputMethodEvent ( QInputMethodEvent * event )

重实现： QGraphicsItem::inputMethodEvent (QInputMethodEvent *event).

[override virtual protected] QVariant QGraphicsTextItem:: inputMethodQuery ( Qt::InputMethodQuery query ) const

重实现： QGraphicsItem::inputMethodQuery (Qt::InputMethodQuery query) const.

[override virtual] bool QGraphicsTextItem:: isObscuredBy (const QGraphicsItem * item ) const

重实现： QGraphicsItem::isObscuredBy (const QGraphicsItem *item) const.

[override virtual protected] void QGraphicsTextItem:: keyPressEvent ( QKeyEvent * event )

重实现： QGraphicsItem::keyPressEvent (QKeyEvent *event).

[override virtual protected] void QGraphicsTextItem:: keyReleaseEvent ( QKeyEvent * event )

重实现： QGraphicsItem::keyReleaseEvent (QKeyEvent *event).

[override virtual protected] void QGraphicsTextItem:: mouseDoubleClickEvent ( QGraphicsSceneMouseEvent * event )

重实现： QGraphicsItem::mouseDoubleClickEvent (QGraphicsSceneMouseEvent *event).

[override virtual protected] void QGraphicsTextItem:: mouseMoveEvent ( QGraphicsSceneMouseEvent * event )

重实现： QGraphicsItem::mouseMoveEvent (QGraphicsSceneMouseEvent *event).

[override virtual protected] void QGraphicsTextItem:: mousePressEvent ( QGraphicsSceneMouseEvent * event )

重实现： QGraphicsItem::mousePressEvent (QGraphicsSceneMouseEvent *event).

[override virtual protected] void QGraphicsTextItem:: mouseReleaseEvent ( QGraphicsSceneMouseEvent * event )

重实现： QGraphicsItem::mouseReleaseEvent (QGraphicsSceneMouseEvent *event).

[override virtual] QPainterPath QGraphicsTextItem:: opaqueArea () const

重实现： QGraphicsItem::opaqueArea () const.

[override virtual] void QGraphicsTextItem:: paint ( QPainter * painter , const QStyleOptionGraphicsItem * option , QWidget * widget )

重实现： QGraphicsItem::paint (QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget).

[override virtual protected] bool QGraphicsTextItem:: sceneEvent ( QEvent * event )

重实现： QGraphicsItem::sceneEvent (QEvent *event).

void QGraphicsTextItem:: setDefaultTextColor (const QColor & col )

Sets the color for unformatted text to col .

另请参阅 defaultTextColor ().

void QGraphicsTextItem:: setDocument ( QTextDocument * document )

Sets the text document document on the item.

另请参阅 document ().

void QGraphicsTextItem:: setFont (const QFont & font )

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

另请参阅 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.

另请参阅 toHtml (), hasFocus ()，和 QGraphicsSimpleTextItem .

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.

另请参阅 toHtml () 和 hasFocus ().

void QGraphicsTextItem:: setTabChangesFocus ( bool b )

若 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.

另请参阅 tabChangesFocus (), ItemIsFocusable ，和 textInteractionFlags ().

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 标志。

另请参阅 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.

若 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.

默认值为 -1。

注意， QGraphicsTextItem keeps a QTextDocument internally, which is used to calculate the text width.

另请参阅 textWidth () 和 QTextDocument::setTextWidth ().

[override virtual] QPainterPath QGraphicsTextItem:: shape () const

重实现： QGraphicsItem::shape () const.

bool QGraphicsTextItem:: tabChangesFocus () const

返回 true 若 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.

另请参阅 setTabChangesFocus ().

Qt::TextInteractionFlags QGraphicsTextItem:: textInteractionFlags () const

Returns the current text interaction flags.

另请参阅 setTextInteractionFlags ().

qreal QGraphicsTextItem:: textWidth () const

Returns the text width.

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

另请参阅 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.

另请参阅 setHtml ().

QString QGraphicsTextItem:: toPlainText () const

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

另请参阅 setPlainText ().

[override virtual] int QGraphicsTextItem:: type () const

重实现： QGraphicsItem::type () const.