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

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

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

 #include <QGraphicsTextItem>

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

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

Свойства

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

Сигналы

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


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

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

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

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

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

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

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

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


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

openExternalLinks : bool

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

Значение по-умолчанию равно 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 ()

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

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.

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

Qt::TextInteractionFlags QGraphicsTextItem::textInteractionFlags () const

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

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

qreal QGraphicsTextItem::textWidth () const

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

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

QString QGraphicsTextItem::toHtml () const

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

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

QString QGraphicsTextItem::toPlainText () const

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

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


Copyright © 2008 Trolltech Торговые марки
Qt 4.3.5