QGraphicsTextItem Class

成员函数文档

[explicit] QGraphicsTextItem::QGraphicsTextItem(QGraphicsItem *parent = nullptr)

构造一个 QGraphicsTextItem。parent 传递给QGraphicsItem 的构造函数。

另请参阅 QGraphicsScene::addItem().

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

构造一个 QGraphicsTextItem，使用text 作为默认纯文本。parent 将传递给QGraphicsItem 的构造函数。

另请参阅 QGraphicsScene::addItem().

[virtual noexcept] QGraphicsTextItem::~QGraphicsTextItem()

摧毁QGraphicsTextItem.

void QGraphicsTextItem::adjustSize()

将文本项目调整为合理大小。

[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

返回未格式化文本使用的默认文本颜色。

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

返回项目的字体，用于渲染文本。

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

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

当用户点击文本项中启用Qt::LinksAccessibleByMouse 或Qt::LinksAccessibleByKeyboard 的链接时，会发出该信号。link 是被点击的链接。

另请参阅 setTextInteractionFlags() 。

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

当用户将鼠标悬停在一个文本项目上的链接上时，就会发出该信号，该链接可启用Qt::LinksAccessibleByMouse 。link 是被悬停的链接。

另请参阅 setTextInteractionFlags() 。

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

将未格式化文本的颜色设置为col 。

另请参阅 defaultTextColor() 。

void QGraphicsTextItem::setDocument(QTextDocument *document)

设置项目上的文本文档document 。

另请参阅 document()。

void QGraphicsTextItem::setFont(const QFont &font)

将用于渲染文本项的字体设置为font 。

另请参阅 font() 。

void QGraphicsTextItem::setHtml(const QString &text)

将项目的文本设置为text ，假定文本为 HTML 格式。如果项目有键盘输入焦点，该函数还将调用ensureVisible() 以确保文本在所有视口中可见。

另请参阅 toHtml()、hasFocus() 和QGraphicsSimpleTextItem 。

void QGraphicsTextItem::setPlainText(const QString &text)

将项目的文本设置为text 。如果项目有键盘输入焦点，该函数还将调用ensureVisible() 以确保文本在所有视口中可见。

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

void QGraphicsTextItem::setTabChangesFocus(bool b)

如果b 为真，则Tab 键将导致窗口部件改变焦点；否则，Tab 键将在文档中插入制表符。

在某些情况下，文本编辑不应允许用户使用Tab 键输入制表符或更改缩进，因为这会破坏焦点链。默认值为 false。

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

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

设置标志flags ，以指定文本项对用户输入的反应。

QGraphicsTextItem 的默认值是Qt::NoTextInteraction 。该函数还影响 ItemIsFocusableQGraphicsItem 标志，如果flags 与Qt::NoTextInteraction 不同，则设置该标志，否则清除该标志。

默认情况下，文本是只读的。要将项目转换为编辑器，请设置Qt::TextEditable 标志。

另请参见 textInteractionFlags().

void QGraphicsTextItem::setTextWidth(qreal width)

设置项目文本的首选宽度。如果实际文本的宽度大于指定的宽度，那么文本将被分成多行。

如果width 设置为-1，那么文本将不会被分成多行，除非通过明确的换行或新段落来强制执行。

默认值为-1。

请注意，QGraphicsTextItem 内部会保留一个QTextDocument ，用于计算文本宽度。

另请参见 textWidth() 和QTextDocument::setTextWidth()。

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

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

bool QGraphicsTextItem::tabChangesFocus() const

如果Tab 键会导致窗口部件改变焦点，则返回true ；否则返回 false。

默认情况下，此行为被禁用，此函数将返回 false。

另请参阅 setTabChangesFocus().

Qt::TextInteractionFlags QGraphicsTextItem::textInteractionFlags() const

返回当前文本交互标志。

另请参阅 setTextInteractionFlags()。

qreal QGraphicsTextItem::textWidth() const

返回文本宽度。

宽度是通过QGraphicsTextItem 内部保存的QTextDocument 计算得出的。

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

QString QGraphicsTextItem::toHtml() const

返回转换为 HTML 格式的项目文本，如果未设置文本，则返回空QString 。

另请参阅 setHtml().

QString QGraphicsTextItem::toPlainText() const

返回转换为纯文本的项目文本，如果未设置文本，则返回空QString 。

另请参阅 setPlainText()。

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

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