QGraphicsTextItem Class

QGraphicsTextItem クラスは、整形されたテキストを表示するためにQGraphicsScene に追加できるテキストアイテムを提供します。詳細...

Header: #include <QGraphicsTextItem>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Inherits: QGraphicsObject

パブリック型

enum anonymous { Type }

プロパティ

パブリック関数

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

再実装パブリック関数

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 を使用することを検討してください。

アイテムのテキストを設定するには、QString を QGraphicsTextItem のコンストラクタに渡すか、setHtml()/setPlainText() を呼び出します。

QGraphicsTextItem は、boundingRect()、shape()、contains() の合理的な実装を提供するために、テキストのフォーマットされたサイズと関連するフォントを使用します。setFont() を呼び出すことで、フォントを設定できます。

setTextInteractionFlags() を使用してQt::TextEditorInteraction フラグを設定することで、項目を編集可能にすることができます。

アイテムの優先テキスト幅は、setTextWidth() で設定でき、textWidth() で取得できます。

注意: HTML テキストを中央に配置するには、アイテムのテキスト幅を設定する必要があります。そうでない場合は、アイテムのテキストを設定した後でadjustSize() を呼び出します。

注意 : QGraphicsTextItem は、デフォルトでhover events を受け入れます。これはsetAcceptHoverEvents() で変更できます。

QGraphicsSimpleTextItem,QGraphicsPathItem,QGraphicsRectItem,QGraphicsEllipseItem,QGraphicsPixmapItem,QGraphicsPolygonItem,QGraphicsLineItem, およびGraphics View Frameworkも参照のこと

メンバ型ドキュメント

enum QGraphicsTextItem::anonymous

仮想関数type() が返す値。

定数説明
QGraphicsTextItem::Type8グラフィックテキスト項目

プロパティ Documentation

QGraphicsTextItemlinkActivated シグナルを発する代わりにQDesktopServices::openUrl() を使って自動的にリンクを開くかどうかを指定します。

デフォルト値はfalse。

アクセス関数:

bool openExternalLinks() const
void setOpenExternalLinks(bool open)

textCursor : QTextCursor

このプロパティは、編集可能テキストアイテムの可視テキストカーソルを表す。

デフォルトでは、アイテムのテキストが設定されていない場合、このプロパティは null テキストカーソルを含み、そうでない場合、アイテムのドキュメントの先頭に配置されたテキストカーソルを含む。

アクセス関数:

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

メンバ関数ドキュメント

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

QGraphicsTextItem を構築します。parentQGraphicsItem のコンストラクタに渡されます。

QGraphicsScene::addItem()も参照してください

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

text をデフォルトのプレーンテキストとして QGraphicsTextItem を構築します。parentQGraphicsItem のコンストラクタに渡されます。

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)

再実装:(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

再実装: (Qt::InputMethodQuery query) const:QGraphicsItem::isObscuredBy(const QGraphicsItem *item) const.

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

再実装: (const QGraphicsItem *item):QGraphicsItem::keyPressEvent(QKeyEvent *event)。

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

再リンプルメント: (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)

link このシグナルは、Qt::LinksAccessibleByMouse を有効にするテキスト・アイテムのリンクにユーザーがカーソルを合わせたときに発行される。

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

再リプルメント: (QGraphicsSceneMouseEvent *event):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 に設定します。アイテムにキーボード入力フォーカスがある場合、この関数はensureVisible() も呼び出して、テキストがすべてのビューポートで表示されるようにします。

toHtml()、hasFocus()、QGraphicsSimpleTextItemも参照

void QGraphicsTextItem::setPlainText(const QString &text)

アイテムのテキストをtext に設定します。 アイテムにキーボード入力フォーカスがある場合、この関数はensureVisible() も呼び出して、テキストがすべてのビューポートで表示されるようにします。

toHtml() およびhasFocus()も参照して ください。

void QGraphicsTextItem::setTabChangesFocus(bool b)

b が true の場合、Tab キーでウィジェットのフォーカスが変更されます。そうでない場合、tab キーでドキュメントにタブが挿入されます。

そうでない場合、タブキーはドキュメントにタブを挿入します。テキスト編集では、フォーカスの連鎖を断ち切るため、Tab キーでタブレータを入力したりインデントを変更したりできない場合があります。デフォルトは false です。

tabChangesFocus()、ItemIsFocusabletextInteractionFlags()も参照

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

フラグflags を設定 し 、 テ キ ス ト 項目がユーザー入力に ど の よ う に反応す る か を指定 し ます。

QGraphicsTextItem のデフォルトはQt::NoTextInteraction です。この関数は、ItemIsFocusableQGraphicsItem フラグにも影響し、flagsQt::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.

©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。