Описание класса QGraphicsTextItem [модуль QtGui]
Класс QGraphicsTextItem предоставляет текстовый элемент, который вы можете добавить на QGraphicsScene для отображения форматированного текста. Далее...
#include <QGraphicsTextItem> Наследует QObject и QGraphicsItem.
Класс был добавлен в Qt 4.2.
Свойства
- 1 свойство, унаследованное от QObject
Открытые функции
- 29 открытых функций, унаследованных от QObject
- 132 открытые функции, унаследованные от QGraphicsItem
Сигналы
- 1 сигнал, унаследованный от QObject
Дополнительные унаследованные члены
- 1 открытый слот, унаследованный от QObject
- 5 статических открытых членов, унаследованных от QObject
- 1 статический открытый член, унаследованный от QGraphicsItem
- 7 защищенных функций, унаследованных от QObject
- 23 защищённые функции, унаследованные от QGraphicsItem
Подробное описание
Класс QGraphicsTextItem предоставляет текстовый элемент, который вы можете добавить на QGraphicsScene для отображения форматированного текста.
Для установки текста элемента, передайте QString в конструктор QGraphicsTextItem или вызовите setHtml()/setPlainText().
QGraphicsTextItem использует размер форматированного текста и связанный с ним шрифт для предоставления обоснованной реализации boundingRect(), shape() и contains(). Вы можете установить шрифт вызвав setFont().
Можно сделать элемент редактируемым установив флаг Qt::TextEditorInteraction используя setTextInteractionFlags().
Желаемая ширина текста элемента может быть установлена с помощью setTextWidth() и получена с помощью textWidth().
Замечание: С целью выравнивания текста HTML по центру, ширина текста элемента должна быть установлена.

Смотрите также QGraphicsSimpleTextItem, QGraphicsPathItem, QGraphicsRectItem, QGraphicsEllipseItem, QGraphicsPixmapItem, QGraphicsPolygonItem, QGraphicsLineItem и Каркас графического представления.
Описание свойств
openExternalLinks : bool
Указывает должен ли QGraphicsTextItem открывать ссылки автоматически с использованием QDesktopServices::openUrl() вместо вырабатывания сигнала linkActivated.
Значение по-умолчанию равно false.
Функции доступа:
- bool openExternalLinks () const
- void setOpenExternalLinks ( bool open )
Это свойство представляет курсор видимого текста в редактируемом текстовом элементе.
По-умолчанию, если текст элемента не был установлен, это свойство содержит пустой текстовый курсор; в противном случае он содержит текстовый курсор, помещённый в начало документа элемента.
Функции доступа:
- QTextCursor textCursor () const
- void setTextCursor ( const QTextCursor & cursor )
Описание функций-членов
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 ()
Настраивает текст элемента на разумный размер.
QColor QGraphicsTextItem::defaultTextColor () const
Возвращает цвет текста по-умолчанию, который используется для неформатированного текста.
Смотрите также setDefaultTextColor().
QTextDocument * QGraphicsTextItem::document () const
Возвращает текстовый документ элемента.
Смотрите также setDocument().
QFont QGraphicsTextItem::font () const
Возвращает шрифт элемента, используемый для отрисовки текста.
Смотрите также setFont().
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::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().
void QGraphicsTextItem::setPlainText ( const QString & text )
Устанавливает текст элемента равным text. Если у элемента есть фокус ввода клавиатуры, эта функция также вызовет ensureVisible() чтобы обеспечить видимость текста на всех областях отображения.
Смотрите также toHtml() и hasFocus().
void QGraphicsTextItem::setTextInteractionFlags ( Qt::TextInteractionFlags flags )
Устанавливает флаги flags для указания как текстовый элемент должен реагировать на ввод пользователя.
Значение по-умолчанию для QGraphicsTextItem это Qt::NoTextInteraction. Установка значения, отличного от Qt::NoTextInteraction, также установит флаг ItemIsFocusable QGraphicsItem.
По-умолчанию, текст находится в режиме только для чтения. Для преобразования элемента в редактор, установить флаг Qt::TextEditable.
Смотрите также textInteractionFlags().
void QGraphicsTextItem::setTextWidth ( qreal width )
Устанавливает желаемую ширину для текста элемента. Если текущий текст шире указанной ширины, он будет разбит на несколько строк.
Если width установлена в -1, то текст не будет разбит на несколько строк, если его не вынудить с помощью явного разрыва строки или нового параграфа.
Значение по умолчанию равно -1.
Заметьте, что QGraphicsTextItem хранит QTextDocument, используемый для расчёта ширины, внутри себя.
Смотрите также textWidth() и QTextDocument::setTextWidth().
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().
|