Главная · Все пространства имен · Все классы · Основные классы · Классы по группам · Модули · Функции

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

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

 #include <QGraphicsTextItem>

Наследует QObject и QGraphicsItem.

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

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

Свойства

• openExternalLinks : bool
• textCursor : QTextCursor

• 1 свойство, унаследованное от QObject

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

• QGraphicsTextItem ( QGraphicsItem * parent = 0 )
• QGraphicsTextItem ( const QString & text, QGraphicsItem * parent = 0 )
• ~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

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

Сигналы

• void linkActivated ( const QString & link )
• void linkHovered ( const QString & link )

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

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

• 1 открытый слот, унаследованный от QObject
• 5 статических открытых членов, унаследованных от QObject
• 1 статический открытый член, унаследованный от 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.

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

• bool openExternalLinks () const
• void setOpenExternalLinks ( bool open )

textCursor : QTextCursor

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

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

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

• 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() и 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. Установка значения, отличного от Qt::NoTextInteraction, также установит флаг ItemIsFocusable QGraphicsItem.

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

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

void QGraphicsTextItem::setTextWidth ( qreal width )

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

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

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

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

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

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().