Главная · Все классы · Все функции · Обзоры

Описание класса QGraphicsTextItem
[модуль QtGui]

Класс QGraphicsTextItem предоставляет текстовый элемент, который вы можете добавить на QGraphicsScene для отображения форматированного текста. Далее...

 #include <QGraphicsTextItem>

Унаследован от QGraphicsObject.

Класс был добавлен в Qt 4.2.

• Список всех членов, включая унаследованные

Свойства

• openExternalLinks : bool
• textCursor : QTextCursor

• 11 properties inherited from QGraphicsObject
• 1 свойство, унаследованное от QObject

Открытые функции

Вновь реализованные открытые функции

• 2 открытые функции, унаследованные от QGraphicsObject
• 29 открытых функций, унаследованных от QObject
• 177 открытых функций, унаследованных от QGraphicsItem

Сигналы

• 9 сигналов, унаследованных от QGraphicsObject
• 1 сигнал, унаследованный от QObject

Переопределённые защищенные функции

• 7 защищенных функций, унаследованных от QObject
• 23 защищённые функции, унаследованные от QGraphicsItem

Дополнительные унаследованные члены

• 1 открытый слот, унаследованный от QObject
• 5 статических открытых членов, унаследованных от QObject
• 2 статических открытых члена, унаследованные от QGraphicsItem
• 7 защищенных функций, унаследованных от QObject
• 23 защищённые функции, унаследованные от QGraphicsItem

Подробное описание

Класс QGraphicsTextItem предоставляет текстовый элемент, который вы можете добавить на QGraphicsScene для отображения форматированного текста.

Если вам нужно только показать в элементе плоский текст, рассмотрите использование взамен QGraphicsSimpleTextItem.

Для установки текста элемента, передайте QString в конструктор QGraphicsTextItem или вызовите setHtml()/setPlainText().

QGraphicsTextItem использует размер форматированного текста и связанный с ним шрифт для предоставления обоснованной реализации boundingRect(), shape() и contains(). Вы можете установить шрифт вызвав setFont().

Можно сделать элемент редактируемым установив флаг Qt::TextEditorInteraction используя setTextInteractionFlags().

Желаемая ширина текста элемента может быть установлена с помощью setTextWidth() и получена с помощью textWidth().

Замечание: С целью выравнивания текста HTML по центру, ширина текста элемента должна быть установлена.

Замечание: QGraphicsTextItem получает события наведения мыши по умолчанию. Вы можете изменить это с помощью setAcceptHoverEvents().

Смотрите также QGraphicsSimpleTextItem, QGraphicsPathItem, QGraphicsRectItem, QGraphicsEllipseItem, QGraphicsPixmapItem, QGraphicsPolygonItem, QGraphicsLineItem и Каркас графического представления.

Описание свойств

openExternalLinks : bool

Указывает должен ли QGraphicsTextItem открывать ссылки автоматически с использованием QDesktopServices::openUrl() вместо вырабатывания сигнала linkActivated.

Значение по-умолчанию равно false.

Функции доступа:

textCursor : QTextCursor

Это свойство представляет курсор видимого текста в редактируемом текстовом элементе.

По-умолчанию, если текст элемента не был установлен, это свойство содержит пустой текстовый курсор; в противном случае он содержит текстовый курсор, помещённый в начало документа элемента.

Функции доступа:

Описание функций-членов

QGraphicsTextItem::QGraphicsTextItem ( QGraphicsItem * parent = 0 )

Создаёт QGraphicsTextItem. parent передаётся в конструктор QGraphicsItem.

Смотрите также QGraphicsScene::addItem().

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

Создаёт QGraphicsTextItem, используя text в качестве текста по-умолчанию. parent передаётся в конструктор QGraphicsItem.

Смотрите также QGraphicsScene::addItem().

QGraphicsTextItem::~QGraphicsTextItem ()

Уничтожает QGraphicsTextItem.

void QGraphicsTextItem::adjustSize ()

Настраивает текст элемента на разумный размер.

QRectF QGraphicsTextItem::boundingRect () const   [virtual]

Переопределено из QGraphicsItem::boundingRect().

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

Переопределено из QGraphicsItem::contains().

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

Переопределено из QGraphicsItem::contextMenuEvent().

QColor QGraphicsTextItem::defaultTextColor () const

Возвращает цвет текста по-умолчанию, который используется для неформатированного текста.

Смотрите также setDefaultTextColor().

QTextDocument * QGraphicsTextItem::document () const

Возвращает текстовый документ элемента.

Смотрите также setDocument().

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

Переопределено из QGraphicsItem::dragEnterEvent().

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

Переопределено из QGraphicsItem::dragLeaveEvent().

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

Переопределено из QGraphicsItem::dragMoveEvent().

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

Переопределено из QGraphicsItem::dropEvent().

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

Переопределено из QGraphicsItem::focusInEvent().

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

Переопределено из QGraphicsItem::focusOutEvent().

QFont QGraphicsTextItem::font () const

Возвращает шрифт элемента, используемый для отрисовки текста.

Смотрите также setFont().

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

Переопределено из QGraphicsItem::hoverEnterEvent().

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

Переопределено из QGraphicsItem::hoverLeaveEvent().

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

Переопределено из QGraphicsItem::hoverMoveEvent().

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

Повторно реализовано из QGraphicsItem::inputMethodEvent().

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

Повторно реализовано из QGraphicsItem::inputMethodQuery().

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

Повторно реализовано из QGraphicsItem::isObscuredBy().

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

Переопределено из QGraphicsItem::keyPressEvent().

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

Переопределено из QGraphicsItem::keyReleaseEvent().

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

Этот сигнал вырабатывается когда пользователь кликает на ссылке в текстовом элементе, который разблокировал Qt::LinksAccessibleByMouse или Qt::LinksAccessibleByKeyboard. link это ссылка которую кликнули.

Смотрите также setTextInteractionFlags().

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

Этот сигнал вырабатывается когда пользователь наводит курсор мышки на ссылку в текстовом элементе, который разблокировал Qt::LinksAccessibleByMouse. link это ссылка на которую навели курсор.

Смотрите также setTextInteractionFlags().

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

Переопределено из QGraphicsItem::mouseDoubleClickEvent().

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

Переопределено из QGraphicsItem::mouseMoveEvent().

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

Переопределено из QGraphicsItem::mousePressEvent().

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

Переопределено из QGraphicsItem::mouseReleaseEvent().

QPainterPath QGraphicsTextItem::opaqueArea () const   [virtual]

Повторно реализовано из QGraphicsItem::opaqueArea().

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

Переопределено из QGraphicsItem::paint().

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

Переопределено из QGraphicsItem::sceneEvent().

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 равно true, клавиша Tab будет вызывать смену фокуса виджета; в противном случае, клавиша будет вставлять табуляцию в документ.

В некоторых случаях редактирования текста пользователю не разрешают вводит табуляторы или изменять отступы, используя клавишу Tab, так как это разорвет последовательность фокуса (focus chain). По умолчанию равно false.

Эта функция была введена в Qt 4.5.

Смотрите также tabChangesFocus(), ItemIsFocusable и textInteractionFlags().

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

Устанавливает флаги flags для указания как текстовый элемент должен реагировать на ввод пользователя.

Значение по-умолчанию для QGraphicsTextItem это Qt::NoTextInteraction. Эта функция также влияет на флаг ItemIsFocusable QGraphicsItem'а, устанавливая его, если flags отличается от Qt::NoTextInteraction, и очищая - в противном случае.

По-умолчанию, текст находится в режиме только для чтения. Для преобразования элемента в редактор, установить флаг Qt::TextEditable.

Смотрите также textInteractionFlags().

void QGraphicsTextItem::setTextWidth ( qreal width )

Устанавливает желаемую ширину для текста элемента. Если текущий текст шире указанной ширины, он будет разбит на несколько строк.

Если width установлена в -1, то текст не будет разбит на несколько строк, если его не вынудить с помощью явного разрыва строки или нового параграфа.

Значение по умолчанию равно -1.

Заметьте, что QGraphicsTextItem хранит QTextDocument, используемый для расчёта ширины, внутри себя.

Смотрите также textWidth() и QTextDocument::setTextWidth().

QPainterPath QGraphicsTextItem::shape () const   [virtual]

Переопределено из QGraphicsItem::shape().

bool QGraphicsTextItem::tabChangesFocus () const

Возвращает true если клавиша Tab вызывает изменение фокуса виджета; в противном случае возвращается false.

По умолчанию, такое поведение отлючено и эта функция будет возвращать false.

Эта функция была введена в Qt 4.5.

Смотрите также setTabChangesFocus().

Qt::TextInteractionFlags QGraphicsTextItem::textInteractionFlags () const

Возвращает текущие флаги взаимодействия текста.

Смотрите также setTextInteractionFlags().

qreal QGraphicsTextItem::textWidth () const

Возвращает ширину текста.

Ширина рассчитывается с помощью QTextDocument, хранимого внутри QGraphicsTextItem.

Смотрите также setTextWidth() и QTextDocument::textWidth().

QString QGraphicsTextItem::toHtml () const

Возвращает текст элемента, преобразованный в HTML, или пустую QString если текст не был установлен.

Смотрите также setHtml().

QString QGraphicsTextItem::toPlainText () const

Возвращает текст элемента, преобразованный в простой текст, или пустую QString если текст не был установлен.

Смотрите также setPlainText().

int QGraphicsTextItem::type () const   [virtual]

Переопределено из QGraphicsItem::type().