Qt:Документация 4.3.2/qgraphicstextitem

Материал из Wiki.crossplatform.ru

Перейти к: навигация, поиск
40px Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

Image:qt-logo.png

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

Image:trolltech-logo.png

Содержание

[править] QGraphicsTextItem Class Reference
[модуль QtGui ]

The QGraphicsTextItem class provides a text item that you can add to a QGraphicsScene to display formatted text. Далее...

 #include <QGraphicsTextItem>

Inherits QObject and QGraphicsItem.

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

[править] Свойства

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

[править] Открытые функции

  • 29 открытых функций, унаследованных от QObject
  • 114 public functions inherited from QGraphicsItem

[править] Сигналы

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

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

  • 1 открытый слот, унаследованный от QObject
  • 5 статических открытых членов, унаследованных от QObject
  • 1 static public member inherited from QGraphicsItem
  • 7 защищенных функций, унаследованных от QObject
  • 23 protected functions inherited from QGraphicsItem

[править] Подробное описание

The QGraphicsTextItem class provides a text item that you can add to a QGraphicsScene to display formatted text.

To set the item's text, pass a QString to QGraphicsTextItem's constructor, or call setHtml()/ setPlainText().

QGraphicsTextItem uses the text's formatted size and the associated font to provide a reasonable implementation of boundingRect(), shape(), and contains(). You can set the font by calling setFont().

It is possible to make the item editable by setting the Qt::TextEditable flag using setTextInteractionFlags().

The item's preferred text width can be set using setTextWidth() and obtained using textWidth().

Note: In order to align HTML text in the center, the item's text width must be set.

center

See also QGraphicsSimpleTextItem, QGraphicsPathItem, QGraphicsRectItem, QGraphicsEllipseItem, QGraphicsPixmapItem, QGraphicsPolygonItem, QGraphicsLineItem, and The Graphics View Framework.


[править] Описание cвойств

[править] openExternalLinks : bool

Specifies whether QGraphicsTextItem should automatically open links using QDesktopServices::openUrl() instead of emitting the anchorClicked signal.

The default value is false.

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

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

[править]
textCursor : QTextCursor

This property represents the visible text cursor in an editable text item.

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

  • QTextCursor textCursor () const
  • void setTextCursor ( const QTextCursor & cursor )

[править] Описание функций-членов

[править]
QGraphicsTextItem::QGraphicsTextItem ( QGraphicsItem * parent = 0 )

Constructs a QGraphicsTextItem. parent is passed to QGraphicsItem's constructor.

See also QGraphicsScene::addItem().

[править]
QGraphicsTextItem::QGraphicsTextItem ( const QString & text, QGraphicsItem * parent = 0 )

Constructs a QGraphicsTextItem, using text as the default plain text. parent is passed to QGraphicsItem's constructor.

See also QGraphicsScene::addItem().

[править]
QGraphicsTextItem::~QGraphicsTextItem ()

Destroys the QGraphicsTextItem.

[править]
void QGraphicsTextItem::adjustSize ()

Adjusts the text item to a reasonable size.

[править]
QColor QGraphicsTextItem::defaultTextColor () const

Returns the default text color that is used to for unformatted text.

See also setDefaultTextColor().

[править]
QTextDocument * QGraphicsTextItem::document () const

Returns the item's text document.

See also setDocument().

[править]
QFont QGraphicsTextItem::font () const

Returns the item's font, which is used to render the text.

See also setFont().

[править]
void QGraphicsTextItem::linkActivated ( const QString & link ) [signal]

This signal is emitted when the user clicks on a link on a text item that enables Qt::LinksAccessibleByMouse or Qt::LinksAccessibleByKeyboard. link is the link that was clicked.

See also setTextInteractionFlags().

[править]
void QGraphicsTextItem::linkHovered ( const QString & link ) [signal]

This signal is emitted when the user hovers over a link on a text item that enables Qt::LinksAccessibleByMouse. link is the link that was hovered over.

See also setTextInteractionFlags().

[править]
void QGraphicsTextItem::setDefaultTextColor ( const QColor & col )

Sets the color for unformatted text to col.

See also defaultTextColor().

[править]
void QGraphicsTextItem::setDocument ( QTextDocument * document )

Sets the text document document on the item.

See also document().

[править]
void QGraphicsTextItem::setFont ( const QFont & font )

Sets the font used to render the text item to font.

See also font().

[править]
void QGraphicsTextItem::setHtml ( const QString & text )

Sets the item's text to text, assuming that text is HTML formatted. If the item has keyboard input focus, this function will also call ensureVisible() to ensure that the text is visible in all viewports.

See also toHtml() and hasFocus().

[править]
void QGraphicsTextItem::setPlainText ( const QString & text )

Sets the item's text to text. If the item has keyboard input focus, this function will also call ensureVisible() to ensure that the text is visible in all viewports.

See also toHtml() and hasFocus().

[править]
void QGraphicsTextItem::setTextInteractionFlags ( Qt::TextInteractionFlags flags )

Sets the flags flags to specify how the text item should react to user input.

The default for a QGraphicsTextItem is Qt::NoTextInteraction. Setting a value different to Qt::NoTextInteraction will also set the ItemIsFocusable QGraphicsItem flag.

By default, the text is read-only. To transform the item into an editor, set the Qt::TextEditable flag.

See also textInteractionFlags().

[править]
void QGraphicsTextItem::setTextWidth ( qreal width )

Sets the preferred width for the item's text. If the actual text is wider than the specified width then it will be broken into multiple lines.

If width is set to -1 then the text will not be broken into multiple lines unless it is enforced through an explicit line break or a new paragraph.

The default value is -1.

See also textWidth().

[править]
Qt::TextInteractionFlags QGraphicsTextItem::textInteractionFlags () const

Returns the current text interaction flags.

See also setTextInteractionFlags().

[править]
qreal QGraphicsTextItem::textWidth () const

Returns the text width.

See also setTextWidth().

[править]
QString QGraphicsTextItem::toHtml () const

Returns the item's text converted to HTML, or an empty QString if no text has been set.

See also setHtml().

[править]
QString QGraphicsTextItem::toPlainText () const

Returns the item's text converted to plain text, or an empty QString if no text has been set.

See also setPlainText().



Copyright © 2007 Trolltech Trademarks
Qt 4.3.2