QGraphicsTextItem Class
QGraphicsTextItem 클래스는 QGraphicsScene 에 추가하여 서식이 지정된 텍스트를 표시할 수 있는 텍스트 항목을 제공합니다. 더 보기...
Header: | #include <QGraphicsTextItem> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
qmake: | QT += widgets |
상속합니다: | QGraphicsObject |
공용 유형
enum | anonymous { Type } |
속성
- openExternalLinks : bool
- textCursor : QTextCursor
공용 함수
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 대신 사용하는 것이 좋습니다.
항목의 텍스트를 설정하려면 QGraphicsTextItem의 생성자에 QString 를 전달하거나 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, 및 그래픽 보기 프레임워크도참조하세요 .
멤버 유형 문서
enum QGraphicsTextItem::anonymous
가상 type() 함수가 반환하는 값입니다.
상수 | Value | 설명 |
---|---|---|
QGraphicsTextItem::Type | 8 | 그래픽 텍스트 항목 |
속성 문서
openExternalLinks : bool
linkActivated 신호를 보내는 대신 QDesktopServices::openUrl()을 사용하여 QGraphicsTextItem 링크를 자동으로 열지 여부를 지정합니다.
기본값은 false입니다.
액세스 기능:
bool | openExternalLinks() const |
void | setOpenExternalLinks(bool open) |
textCursor : QTextCursor
이 속성은 편집 가능한 텍스트 항목에서 보이는 텍스트 커서를 나타냅니다.
기본적으로 항목의 텍스트가 설정되지 않은 경우 이 속성에는 널 텍스트 커서가 포함되며, 그렇지 않은 경우 항목의 문서 시작 부분에 배치된 텍스트 커서가 포함됩니다.
액세스 함수:
QTextCursor | textCursor() const |
void | setTextCursor(const QTextCursor &cursor) |
멤버 함수 문서
[explicit]
QGraphicsTextItem::QGraphicsTextItem(QGraphicsItem *parent = nullptr)
QGraphicsItem 의 생성자에 parent 을 전달합니다.
QGraphicsScene::addItem()도 참조하십시오 .
[explicit]
QGraphicsTextItem::QGraphicsTextItem(const QString &text, QGraphicsItem *parent = nullptr)
text 을 기본 일반 텍스트로 사용하여 QGraphicsTextItem을 구축합니다. 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 * 이벤트).
QColor QGraphicsTextItem::defaultTextColor() const
서식이 지정되지 않은 텍스트에 사용되는 기본 텍스트 색상을 반환합니다.
setDefaultTextColor()도 참조하세요 .
QTextDocument *QGraphicsTextItem::document() const
항목의 텍스트 문서를 반환합니다.
setDocument()도 참조하세요 .
[override virtual protected]
void QGraphicsTextItem::dragEnterEvent(QGraphicsSceneDragDropEvent *event)
다시 구현합니다: QGraphicsItem::dragEnterEvent(QGraphicsSceneDragDropEvent * 이벤트).
[override virtual protected]
void QGraphicsTextItem::dragLeaveEvent(QGraphicsSceneDragDropEvent *event)
다시 구현합니다: QGraphicsItem::dragLeaveEvent(QGraphicsSceneDragDropEvent * 이벤트).
[override virtual protected]
void QGraphicsTextItem::dragMoveEvent(QGraphicsSceneDragDropEvent *event)
다시 구현합니다: QGraphicsItem::dragMoveEvent(QGraphicsSceneDragDropEvent * 이벤트).
[override virtual protected]
void QGraphicsTextItem::dropEvent(QGraphicsSceneDragDropEvent *event)
다시 구현합니다: QGraphicsItem::dropEvent(QGraphicsSceneDragDropEvent * 이벤트).
[override virtual protected]
void QGraphicsTextItem::focusInEvent(QFocusEvent *event)
다시 구현합니다: QGraphicsItem::focusInEvent(QFocusEvent * 이벤트).
[override virtual protected]
void QGraphicsTextItem::focusOutEvent(QFocusEvent *event)
다시 구현합니다: QGraphicsItem::focusOutEvent(QFocusEvent * 이벤트).
QFont QGraphicsTextItem::font() const
텍스트를 렌더링하는 데 사용되는 항목의 글꼴을 반환합니다.
setFont()도 참조하세요 .
[override virtual protected]
void QGraphicsTextItem::hoverEnterEvent(QGraphicsSceneHoverEvent *event)
다시 구현합니다: QGraphicsItem::hoverEnterEvent(QGraphicsSceneHoverEvent * 이벤트).
[override virtual protected]
void QGraphicsTextItem::hoverLeaveEvent(QGraphicsSceneHoverEvent *event)
다시 구현합니다: QGraphicsItem::hoverLeaveEvent(QGraphicsSceneHoverEvent * 이벤트).
[override virtual protected]
void QGraphicsTextItem::hoverMoveEvent(QGraphicsSceneHoverEvent *event)
다시 구현합니다: QGraphicsItem::hoverMoveEvent(QGraphicsSceneHoverEvent * 이벤트).
[override virtual protected]
void QGraphicsTextItem::inputMethodEvent(QInputMethodEvent *event)
다시 구현합니다: QGraphicsItem::inputMethodEvent(Q입력메소드이벤트 *이벤트).
[override virtual protected]
QVariant QGraphicsTextItem::inputMethodQuery(Qt::InputMethodQuery query) const
재구현합니다: QGraphicsItem::inputMethodQuery(Qt::InputMethodQuery 쿼리) 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 * 이벤트).
[override virtual protected]
void QGraphicsTextItem::keyReleaseEvent(QKeyEvent *event)
다시 구현합니다: QGraphicsItem::keyReleaseEvent(QKeyEvent * 이벤트).
[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 * 이벤트).
[override virtual protected]
void QGraphicsTextItem::mouseMoveEvent(QGraphicsSceneMouseEvent *event)
다시 구현합니다: QGraphicsItem::mouseMoveEvent(QGraphicsSceneMouseEvent * 이벤트).
[override virtual protected]
void QGraphicsTextItem::mousePressEvent(QGraphicsSceneMouseEvent *event)
다시 구현합니다: QGraphicsItem::mousePressEvent(QGraphicsSceneMouseEvent * 이벤트).
[override virtual protected]
void QGraphicsTextItem::mouseReleaseEvent(QGraphicsSceneMouseEvent *event)
다시 구현합니다: QGraphicsItem::mouseReleaseEvent(QGraphicsSceneMouseEvent * 이벤트).
[override virtual]
QPainterPath QGraphicsTextItem::opaqueArea() const
재구현합니다: QGraphicsItem::opaqueArea() const.
[override virtual]
void QGraphicsTextItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)
재구현합니다: QGraphicsItem::paint(QPainter *페인터, const Q스타일옵션그래픽아이템 *옵션, Q위젯 *위젯).
[override virtual protected]
bool QGraphicsTextItem::sceneEvent(QEvent *event)
다시 구현합니다: QGraphicsItem::sceneEvent(QEvent * 이벤트).
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)
텍스트가 HTML 형식이라고 가정하여 항목의 텍스트를 text 로 설정합니다. 항목에 키보드 입력 포커스가 있는 경우 이 함수는 ensureVisible()도 호출하여 모든 뷰포트에서 텍스트가 표시되도록 합니다.
toHtml(), hasFocus() 및 QGraphicsSimpleTextItem 를참조하세요 .
void QGraphicsTextItem::setPlainText(const QString &text)
항목의 텍스트를 text 로 설정합니다. 항목에 키보드 입력 포커스가 있는 경우 이 함수는 ensureVisible()도 호출하여 모든 뷰포트에서 텍스트가 표시되도록 합니다.
toHtml() 및 hasFocus()도 참조하세요 .
void QGraphicsTextItem::setTabChangesFocus(bool b)
b Tab 키가 참이면 위젯의 초점이 변경되고, 그렇지 않으면 탭 키가 문서에 탭을 삽입합니다.
경우에 따라 텍스트 편집 시 사용자가 표를 입력하거나 Tab 키를 사용하여 들여쓰기를 변경하면 포커스 체인이 끊어지므로 허용하지 않아야 합니다. 기본값은 거짓입니다.
tabChangesFocus(), ItemIsFocusable, 및 textInteractionFlags()도 참조하세요 .
void QGraphicsTextItem::setTextInteractionFlags(Qt::TextInteractionFlags flags)
flags 플래그를 설정하여 텍스트 항목이 사용자 입력에 반응하는 방식을 지정합니다.
QGraphicsTextItem 의 기본값은 Qt::NoTextInteraction 입니다. 이 함수는 flags 이 Qt::NoTextInteraction 과 다른 경우 설정하고 그렇지 않으면 지움으로써 ItemIsFocusable QGraphicsItem 플래그에도 영향을 줍니다.
기본적으로 텍스트는 읽기 전용입니다. 항목을 편집기로 변환하려면 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.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.