Viadeo Twitter Google Bookmarks ! Facebook Digg del.icio.us MySpace Yahoo MyWeb Blinklist Netvouz Reddit Simpy StumbleUpon Bookmarks Windows Live Favorites 
Logo Documentation Qt ·  Page d'accueil  ·  Toutes les classes  ·  Classes principales  ·  Annotées  ·  Classes groupées  ·  Modules  ·  Fonctions  · 

QGraphicsSimpleTextItem Class

The QGraphicsSimpleTextItem class provides a simple text path item that you can add to a QGraphicsScene. More...

 #include <QGraphicsSimpleTextItem>

Inherits: QAbstractGraphicsShapeItem.

This class was introduced in Qt 4.2.

Public Types

enum CacheMode { NoCache, ItemCoordinateCache, DeviceCoordinateCache }
enum GraphicsItemChange { ItemEnabledChange, ItemEnabledHasChanged, ItemMatrixChange, ItemPositionChange, ..., ItemScenePositionHasChanged }
enum GraphicsItemFlag { ItemIsMovable, ItemIsSelectable, ItemIsFocusable, ItemClipsToShape, ..., ItemSendsScenePositionChanges }
flags GraphicsItemFlags
enum PanelModality { NonModal, PanelModal, SceneModal }

Public Functions

QGraphicsItem(QGraphicsItem * parent = 0)
QGraphicsSimpleTextItem(QGraphicsItem * parent = 0)
QGraphicsSimpleTextItem(const QString & text, QGraphicsItem * parent = 0)
virtual ~QGraphicsItem()
~QGraphicsSimpleTextItem()
bool acceptDrops() const
bool acceptHoverEvents() const
bool acceptTouchEvents() const
Qt::MouseButtons acceptedMouseButtons() const
virtual void advance(int phase)
virtual QRectF boundingRect() const = 0
QRegion boundingRegion(const QTransform & itemToDeviceTransform) const
qreal boundingRegionGranularity() const
CacheMode cacheMode() const
QList<QGraphicsItem *> childItems() const
QRectF childrenBoundingRect() const
void clearFocus()
QPainterPath clipPath() const
virtual bool collidesWithItem(const QGraphicsItem * other, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const
virtual bool collidesWithPath(const QPainterPath & path, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const
QList<QGraphicsItem *> collidingItems(Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const
QGraphicsItem * commonAncestorItem(const QGraphicsItem * other) const
virtual bool contains(const QPointF & point) const
QCursor cursor() const
QVariant data(int key) const
QTransform deviceTransform(const QTransform & viewportTransform) const
qreal effectiveOpacity() const
void ensureVisible(const QRectF & rect = QRectF(), int xmargin = 50, int ymargin = 50)
void ensureVisible(qreal x, qreal y, qreal w, qreal h, int xmargin = 50, int ymargin = 50)
bool filtersChildEvents() const
GraphicsItemFlags flags() const
QGraphicsItem * focusItem() const
QGraphicsItem * focusProxy() const
QFont font() const
void grabKeyboard()
void grabMouse()
QGraphicsEffect * graphicsEffect() const
QGraphicsItemGroup * group() const
bool hasCursor() const
bool hasFocus() const
void hide()
Qt::InputMethodHints inputMethodHints() const
void installSceneEventFilter(QGraphicsItem * filterItem)
bool isActive() const
bool isAncestorOf(const QGraphicsItem * child) const
bool isBlockedByModalPanel(QGraphicsItem ** blockingPanel = 0) const
bool isClipped() const
bool isEnabled() const
bool isObscured() const
bool isObscured(qreal x, qreal y, qreal w, qreal h) const
bool isObscured(const QRectF & rect) const
virtual bool isObscuredBy(const QGraphicsItem * item) const
bool isPanel() const
bool isSelected() const
bool isUnderMouse() const
bool isVisible() const
bool isVisibleTo(const QGraphicsItem * parent) const
bool isWidget() const
bool isWindow() const
QTransform itemTransform(const QGraphicsItem * other, bool * ok = 0) const
QPointF mapFromItem(const QGraphicsItem * item, const QPointF & point) const
QPolygonF mapFromItem(const QGraphicsItem * item, const QRectF & rect) const
QPolygonF mapFromItem(const QGraphicsItem * item, const QPolygonF & polygon) const
QPainterPath mapFromItem(const QGraphicsItem * item, const QPainterPath & path) const
QPolygonF mapFromItem(const QGraphicsItem * item, qreal x, qreal y, qreal w, qreal h) const
QPointF mapFromItem(const QGraphicsItem * item, qreal x, qreal y) const
QPointF mapFromParent(const QPointF & point) const
QPolygonF mapFromParent(const QRectF & rect) const
QPolygonF mapFromParent(const QPolygonF & polygon) const
QPainterPath mapFromParent(const QPainterPath & path) const
QPolygonF mapFromParent(qreal x, qreal y, qreal w, qreal h) const
QPointF mapFromParent(qreal x, qreal y) const
QPointF mapFromScene(const QPointF & point) const
QPolygonF mapFromScene(const QRectF & rect) const
QPolygonF mapFromScene(const QPolygonF & polygon) const
QPainterPath mapFromScene(const QPainterPath & path) const
QPolygonF mapFromScene(qreal x, qreal y, qreal w, qreal h) const
QPointF mapFromScene(qreal x, qreal y) const
QRectF mapRectFromItem(const QGraphicsItem * item, const QRectF & rect) const
QRectF mapRectFromItem(const QGraphicsItem * item, qreal x, qreal y, qreal w, qreal h) const
QRectF mapRectFromParent(const QRectF & rect) const
QRectF mapRectFromParent(qreal x, qreal y, qreal w, qreal h) const
QRectF mapRectFromScene(const QRectF & rect) const
QRectF mapRectFromScene(qreal x, qreal y, qreal w, qreal h) const
QRectF mapRectToItem(const QGraphicsItem * item, const QRectF & rect) const
QRectF mapRectToItem(const QGraphicsItem * item, qreal x, qreal y, qreal w, qreal h) const
QRectF mapRectToParent(const QRectF & rect) const
QRectF mapRectToParent(qreal x, qreal y, qreal w, qreal h) const
QRectF mapRectToScene(const QRectF & rect) const
QRectF mapRectToScene(qreal x, qreal y, qreal w, qreal h) const
QPointF mapToItem(const QGraphicsItem * item, const QPointF & point) const
QPolygonF mapToItem(const QGraphicsItem * item, const QRectF & rect) const
QPolygonF mapToItem(const QGraphicsItem * item, const QPolygonF & polygon) const
QPainterPath mapToItem(const QGraphicsItem * item, const QPainterPath & path) const
QPolygonF mapToItem(const QGraphicsItem * item, qreal x, qreal y, qreal w, qreal h) const
QPointF mapToItem(const QGraphicsItem * item, qreal x, qreal y) const
QPointF mapToParent(const QPointF & point) const
QPolygonF mapToParent(const QRectF & rect) const
QPolygonF mapToParent(const QPolygonF & polygon) const
QPainterPath mapToParent(const QPainterPath & path) const
QPolygonF mapToParent(qreal x, qreal y, qreal w, qreal h) const
QPointF mapToParent(qreal x, qreal y) const
QPointF mapToScene(const QPointF & point) const
QPolygonF mapToScene(const QRectF & rect) const
QPolygonF mapToScene(const QPolygonF & polygon) const
QPainterPath mapToScene(const QPainterPath & path) const
QPolygonF mapToScene(qreal x, qreal y, qreal w, qreal h) const
QPointF mapToScene(qreal x, qreal y) const
void moveBy(qreal dx, qreal dy)
qreal opacity() const
virtual QPainterPath opaqueArea() const
virtual void paint(QPainter * painter, const QStyleOptionGraphicsItem * option, QWidget * widget = 0) = 0
QGraphicsItem * panel() const
PanelModality panelModality() const
QGraphicsItem * parentItem() const
QGraphicsObject * parentObject() const
QGraphicsWidget * parentWidget() const
QPointF pos() const
void removeSceneEventFilter(QGraphicsItem * filterItem)
void resetTransform()
qreal rotation() const
qreal scale() const
QGraphicsScene * scene() const
QRectF sceneBoundingRect() const
QPointF scenePos() const
QTransform sceneTransform() const
void scroll(qreal dx, qreal dy, const QRectF & rect = QRectF())
void setAcceptDrops(bool on)
void setAcceptHoverEvents(bool enabled)
void setAcceptTouchEvents(bool enabled)
void setAcceptedMouseButtons(Qt::MouseButtons buttons)
void setActive(bool active)
void setBoundingRegionGranularity(qreal granularity)
void setCacheMode(CacheMode mode, const QSize & logicalCacheSize = QSize())
void setCursor(const QCursor & cursor)
void setData(int key, const QVariant & value)
void setEnabled(bool enabled)
void setFiltersChildEvents(bool enabled)
void setFlag(GraphicsItemFlag flag, bool enabled = true)
void setFlags(GraphicsItemFlags flags)
void setFocus(Qt::FocusReason focusReason = Qt::OtherFocusReason)
void setFocusProxy(QGraphicsItem * item)
void setFont(const QFont & font)
void setGraphicsEffect(QGraphicsEffect * effect)
void setGroup(QGraphicsItemGroup * group)
void setInputMethodHints(Qt::InputMethodHints hints)
void setOpacity(qreal opacity)
void setPanelModality(PanelModality panelModality)
void setParentItem(QGraphicsItem * newParent)
void setPos(const QPointF & pos)
void setPos(qreal x, qreal y)
void setRotation(qreal angle)
void setScale(qreal factor)
void setSelected(bool selected)
void setText(const QString & text)
void setToolTip(const QString & toolTip)
void setTransform(const QTransform & matrix, bool combine = false)
void setTransformOriginPoint(const QPointF & origin)
void setTransformOriginPoint(qreal x, qreal y)
void setTransformations(const QList<QGraphicsTransform *> & transformations)
void setVisible(bool visible)
void setX(qreal x)
void setY(qreal y)
void setZValue(qreal z)
virtual QPainterPath shape() const
void show()
void stackBefore(const QGraphicsItem * sibling)
QString text() const
QGraphicsObject * toGraphicsObject()
const QGraphicsObject * toGraphicsObject() const
QString toolTip() const
QGraphicsItem * topLevelItem() const
QGraphicsWidget * topLevelWidget() const
QTransform transform() const
QPointF transformOriginPoint() const
QList<QGraphicsTransform *> transformations() const
virtual int type() const
void ungrabKeyboard()
void ungrabMouse()
void unsetCursor()
void update(const QRectF & rect = QRectF())
void update(qreal x, qreal y, qreal width, qreal height)
QGraphicsWidget * window() const
qreal x() const
qreal y() const
qreal zValue() const

Reimplemented Public Functions

virtual QRectF boundingRect() const
virtual bool contains(const QPointF & point) const
virtual bool isObscuredBy(const QGraphicsItem * item) const
virtual QPainterPath opaqueArea() const
virtual void paint(QPainter * painter, const QStyleOptionGraphicsItem * option, QWidget * widget)
virtual QPainterPath shape() const
virtual int type() const

Static Public Members

const int Type
const int UserType

Protected Functions

virtual void contextMenuEvent(QGraphicsSceneContextMenuEvent * event)
virtual void dragEnterEvent(QGraphicsSceneDragDropEvent * event)
virtual void dragLeaveEvent(QGraphicsSceneDragDropEvent * event)
virtual void dragMoveEvent(QGraphicsSceneDragDropEvent * event)
virtual void dropEvent(QGraphicsSceneDragDropEvent * event)
virtual void focusInEvent(QFocusEvent * event)
virtual void focusOutEvent(QFocusEvent * event)
virtual void hoverEnterEvent(QGraphicsSceneHoverEvent * event)
virtual void hoverLeaveEvent(QGraphicsSceneHoverEvent * event)
virtual void hoverMoveEvent(QGraphicsSceneHoverEvent * event)
virtual void inputMethodEvent(QInputMethodEvent * event)
virtual QVariant inputMethodQuery(Qt::InputMethodQuery query) const
virtual QVariant itemChange(GraphicsItemChange change, const QVariant & value)
virtual void keyPressEvent(QKeyEvent * event)
virtual void keyReleaseEvent(QKeyEvent * event)
virtual void mouseDoubleClickEvent(QGraphicsSceneMouseEvent * event)
virtual void mouseMoveEvent(QGraphicsSceneMouseEvent * event)
virtual void mousePressEvent(QGraphicsSceneMouseEvent * event)
virtual void mouseReleaseEvent(QGraphicsSceneMouseEvent * event)
void prepareGeometryChange()
virtual bool sceneEvent(QEvent * event)
virtual bool sceneEventFilter(QGraphicsItem * watched, QEvent * event)
void updateMicroFocus()
virtual void wheelEvent(QGraphicsSceneWheelEvent * event)

Detailed Description

The QGraphicsSimpleTextItem class provides a simple text path item that you can add to a QGraphicsScene.

To set the item's text, you can either pass a QString to QGraphicsSimpleTextItem's constructor, or call setText() to change the text later. To set the text fill color, call setBrush().

The simple text item can have both a fill and an outline; setBrush() will set the text fill (i.e., text color), and setPen() sets the pen that will be used to draw the text outline. (The latter can be slow, especially for complex pens, and items with long text content.) If all you want is to draw a simple line of text, you should call setBrush() only, and leave the pen unset; QGraphicsSimpleTextItem's pen is by default Qt::NoPen.

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

QGraphicsSimpleText does not display rich text; instead, you can use QGraphicsTextItem, which provides full text control capabilities.

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

Member Function Documentation

QGraphicsSimpleTextItem::QGraphicsSimpleTextItem(QGraphicsItem * parent = 0)

Constructs a QGraphicsSimpleTextItem.

parent is passed to QGraphicsItem's constructor.

See also QGraphicsScene::addItem().

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

Constructs a QGraphicsSimpleTextItem, using text as the default plain text.

parent is passed to QGraphicsItem's constructor.

See also QGraphicsScene::addItem().

QGraphicsSimpleTextItem::~QGraphicsSimpleTextItem()

Destroys the QGraphicsSimpleTextItem.

QRectF QGraphicsSimpleTextItem::boundingRect() const [virtual]

Reimplemented from QGraphicsItem::boundingRect().

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

Reimplemented from QGraphicsItem::contains().

QFont QGraphicsSimpleTextItem::font() const

Returns the font that is used to draw the item's text.

See also setFont().

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

Reimplemented from QGraphicsItem::isObscuredBy().

QPainterPath QGraphicsSimpleTextItem::opaqueArea() const [virtual]

Reimplemented from QGraphicsItem::opaqueArea().

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

Reimplemented from QGraphicsItem::paint().

void QGraphicsSimpleTextItem::setFont(const QFont & font)

Sets the font that is used to draw the item's text to font.

See also font().

void QGraphicsSimpleTextItem::setText(const QString & text)

Sets the item's text to text. The text will be displayed as plain text. Newline characters ('\n') as well as characters of type QChar::LineSeparator will cause item to break the text into multiple lines.

See also text().

QPainterPath QGraphicsSimpleTextItem::shape() const [virtual]

Reimplemented from QGraphicsItem::shape().

QString QGraphicsSimpleTextItem::text() const

Returns the item's text.

See also setText().

int QGraphicsSimpleTextItem::type() const [virtual]

Reimplemented from QGraphicsItem::type().

© 2012 Nokia Corporation and/or its subsidiaries. Documentation contributions included herein are the copyrights of their respective owners.


The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.

Documentation sources may be obtained from www.qt-project.org.


Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide. All other trademarks are property of their respective owners. Privacy Policy
Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. Qt 5.0-snapshot
Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !
 
 
Developpez.com

Nous contacter

Participez

Informations légales

 
Services

Forum Qt

Blogs

Hébergement

 
Partenaires

Hébergement Web