QGraphicsTextItem

La classe QGraphicsTextItem fournit un élément que vous pouvez ajouter à une QGraphicsScene pour afficher du texte formaté. Plus d'informations...

#include <QGraphicsTextItem>

Voir la position dans l'arbre des classes.

Héritage

Hérite de QGraphicsObject.

Cette classe a été introduite dans Qt 4.2.

Description détaillée

La classe QGraphicsTextItem fournit un élément que vous pouvez ajouter à une QGraphicsScene pour afficher du texte formaté.

Si vous avez seulement besoin d'afficher un texte brut dans un élément, envisagez d'utiliser plutôt QGraphicsSimpleTextItem.

Pour renseigner le texte de l'élément, passez une QString au constructeur de QGraphicsTextItem ou appelez setHtml()/setPlainText().

QGraphicsTextItem utilise la taille du texte formaté et la police associée pour fournir une implémentation raisonnable de boundingRect(), shape() et contains(). Vous pouvez fixer la police en appelant setFont().

Il est possible de rendre l'élément éditable en activant le drapeau Qt::TextEditorInteraction avec setTextInteractionFlags().

La largeur de texte préférée peut être fixée avec setTextWidth() et connue en utilisant textWidth().

Note : pour un alignement centré de texte HTML, la largeur de l'élément doit être fixée.

Note : QGraphicsTextItem accepte les événements de survol par défaut. Cela peut être changé avec setAcceptHoverEvents().

Voir aussi QGraphicsSimpleTextItem, QGraphicsPathItem, QGraphicsRectItem, QGraphicsEllipseItem, QGraphicsPixmapItem, QGraphicsPolygonItem, QGraphicsLineItem et le Framework Vue Graphique.

Propriétés

openExternalLinks : bool

Spécifie si le QGraphicsTextItem doit automatiquement ouvrir les liens en utilisant QDesktopServices::openUrl() au lieu d'émettre le signal linkActivated.

La valeur par défaut est false.

Fonctions d'accès

bool openExternalLinks () const

void setOpenExternalLinks ( bool open )

textCursor : QTextCursor

Cette propriété représente le curseur de texte visible dans un élément éditable.

Par défaut, si le texte de l'élément n'a pas été renseigné, cette propriété contient un curseur de texte null ; sinon elle contient un curseur placé au début du document de l'élément.

Fonctions d'accès

QTextCursor textCursor () const

void setTextCursor ( const QTextCursor & cursor )

Fonctions membres

QGraphicsTextItem::QGraphicsTextItem ( QGraphicsItem * parent = 0 )

Construit un QGraphicsTextItem. parent est passé au constructeur de QGraphicsItem.

Voir aussi QGraphicsScene::addItem().

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

Construit un QGraphicsTextItem, en utilisant text comme texte par défaut. parent est passé au constructeur de QGraphicsItem.

Voir aussi QGraphicsScene::addItem().

QGraphicsTextItem::~QGraphicsTextItem ()

Détruit le QGraphicsTextItem.

void QGraphicsTextItem::adjustSize ()

Ajuste l'élément à une taille convenable.

QRectF QGraphicsTextItem::boundingRect () const [virtual]

Réimplémentation de QGraphicsItem::boundingRect().

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

Réimplémentation de QGraphicsItem::contains().

void QGraphicsTextItem::contextMenuEvent ( QGraphicsSceneContextMenuEvent * event ) [virtual protected]

Réimplémentation de QGraphicsItem::contextMenuEvent().

QColor QGraphicsTextItem::defaultTextColor () const

Renvoie la couleur de texte par défaut utilisée pour le texte non formaté.

Voir aussi setDefaultTextColor().

QTextDocument * QGraphicsTextItem::document () const

Renvoie le document texte de l'élément.

Voir aussi setDocument().

void QGraphicsTextItem::dragEnterEvent ( QGraphicsSceneDragDropEvent * event ) [virtual protected]

Réimplémentation de QGraphicsItem::dragEnterEvent().

void QGraphicsTextItem::dragLeaveEvent ( QGraphicsSceneDragDropEvent * event ) [virtual protected]

Réimplémentation de QGraphicsItem::dragLeaveEvent().

void QGraphicsTextItem::dragMoveEvent ( QGraphicsSceneDragDropEvent * event ) [virtual protected]

Réimplémentation de QGraphicsItem::dragMoveEvent().

void QGraphicsTextItem::dropEvent ( QGraphicsSceneDragDropEvent * event ) [virtual protected]

Réimplémentation de QGraphicsItem::dropEvent().

void QGraphicsTextItem::focusInEvent ( QFocusEvent * event ) [virtual protected]

Réimplémentation de QGraphicsItem::focusInEvent().

void QGraphicsTextItem::focusOutEvent ( QFocusEvent * event ) [virtual protected]

Réimplémentation de QGraphicsItem::focusOutEvent().

QFont QGraphicsTextItem::font () const

Renvoie la police de caractères de l'élément, utilisée pour le rendu du texte.

Voir aussi setFont().

void QGraphicsTextItem::hoverEnterEvent ( QGraphicsSceneHoverEvent * event ) [virtual protected]

Réimplémentation de QGraphicsItem::hoverEnterEvent().

void QGraphicsTextItem::hoverLeaveEvent ( QGraphicsSceneHoverEvent * event ) [virtual protected]

Réimplémentation de QGraphicsItem::hoverLeaveEvent().

void QGraphicsTextItem::hoverMoveEvent ( QGraphicsSceneHoverEvent * event ) [virtual protected]

Réimplémentation de QGraphicsItem::hoverMoveEvent().

void QGraphicsTextItem::inputMethodEvent ( QInputMethodEvent * event ) [virtual protected]

Réimplémentation de QGraphicsItem::inputMethodEvent().

QVariant QGraphicsTextItem::inputMethodQuery ( Qt::InputMethodQuery query ) const [virtual protected]

Réimplémentation de QGraphicsItem::inputMethodQuery().

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

Réimplémentation de QGraphicsItem::isObscuredBy().

void QGraphicsTextItem::keyPressEvent ( QKeyEvent * event ) [virtual protected]

Réimplémentation de QGraphicsItem::keyPressEvent().

void QGraphicsTextItem::keyReleaseEvent ( QKeyEvent * event ) [virtual protected]

Réimplémentation de QGraphicsItem::keyReleaseEvent().

void QGraphicsTextItem::linkActivated ( const QString & link ) [signal]

Ce signal est émis lorsque l'utilisateur clique sur un lien dans un élément texte pour lequel Qt::LinksAccessibleByMouse ou Qt::LinksAccessibleByKeyboard est actif. link est le lien qui a été cliqué.

Voir aussi setTextInteractionFlags().

void QGraphicsTextItem::linkHovered ( const QString & link ) [signal]

Ce signal est émis lorsque l'utilisateur survole un lien dans un élément texte pour lequel Qt::LinksAccessibleByMouse est activé. link est le lien qui a été survolé.

Voir aussi setTextInteractionFlags().

void QGraphicsTextItem::mouseDoubleClickEvent ( QGraphicsSceneMouseEvent * event ) [virtual protected]

Réimplémentation de QGraphicsItem::mouseDoubleClickEvent().

void QGraphicsTextItem::mouseMoveEvent ( QGraphicsSceneMouseEvent * event ) [virtual protected]

Réimplémentation de QGraphicsItem::mouseMoveEvent().

void QGraphicsTextItem::mousePressEvent ( QGraphicsSceneMouseEvent * event ) [virtual protected]

Réimplémentation de QGraphicsItem::mousePressEvent().

void QGraphicsTextItem::mouseReleaseEvent ( QGraphicsSceneMouseEvent * event ) [virtual protected]

Réimplémentation de QGraphicsItem::mouseReleaseEvent().

QPainterPath QGraphicsTextItem::opaqueArea () const [virtual]

Réimplémentation de QGraphicsItem::opaqueArea().

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

Réimplémentation de QGraphicsItem::paint().

bool QGraphicsTextItem::sceneEvent ( QEvent * event ) [virtual protected]

Réimplémentation de QGraphicsItem::sceneEvent().

void QGraphicsTextItem::setDefaultTextColor ( const QColor & col )

Définit col comme couleur de texte non formaté.

Voir aussi defaultTextColor().

void QGraphicsTextItem::setDocument ( QTextDocument * document )

Affecte le document texte document à l'élément.

Voir aussi document().

void QGraphicsTextItem::setFont ( const QFont & font )

Spécifie font comme police de caractères de rendu de l'élément.

Voir aussi font().

void QGraphicsTextItem::setHtml ( const QString & text )

Affecte text au texte de l'élément, en supposant que text est au format HTML. Si l'élément possède le focus des entrées clavier, cette fonction appellera aussi ensureVisible() pour garantir que le texte sera visible sur tous les affichages.

Voir aussi toHtml(), hasFocus() et QGraphicsSimpleTextItem.

void QGraphicsTextItem::setPlainText ( const QString & text )

Affecte text au texte de l'élément. Si l'élément possède le focus des entrées clavier, cette fonction appellera aussi ensureVisible() pour garantir que le texte sera visible sur tous les affichages.

Voir aussi toHtml() et hasFocus().

void QGraphicsTextItem::setTabChangesFocus ( bool b )

Si b est true, la touche Tab causera un déplacement du focus du widget ; sinon, la touche Tab insèrera une tabulation dans le document.

Dans certains cas les éditeurs de texte ne doivent pas autoriser l'utilisateur à insérer des tabulations ou à changer l'indentation avec la touche Tab, étant donné que cela interrompt la chaîne de focus. Par défaut ce comportement est désactivé.

Cette fonction a été introduite dans Qt 4.5.

Voir aussi tabChangesFocus(), ItemIsFocusable et textInteractionFlags().

void QGraphicsTextItem::setTextInteractionFlags ( Qt::TextInteractionFlags flags )

Les drapeaux flags spécifient la façon dont l'élément doit réagir aux entrées de l'utilisateur.

Le comportement par défaut pour un QGraphicsTextItem est Qt::NoTextInteraction. Cette fonction modifie aussi le drapeau ItemIsFocusable de QGraphicsItem en l'activant si flags est différent de Qt::NoTextInteraction et en le désactivant sinon.

Par défaut, le texte est en lecture seule. Pour transformer l'élément en éditeur, activez le drapeau Qt::TextEditable .

Voir aussi textInteractionFlags().

void QGraphicsTextItem::setTextWidth ( qreal width )

Spécifie la largeur préférée du texte de l'élément. Si le texte contenu est plus large que la largeur spécifiée il sera découpé en lignes multiples.

Si width est fixé à -1 alors le texte ne sera pas découpé en lignes sauf si les changements de lignes sont forcés par des sauts de ligne explicites ou des changements de paragraphe.

La valeur par défaut est -1.

Notez que QGraphicsTextItem possède un QTextDocument interne, qui est utilisé pour calculer la largeur de texte.

Voir aussi textWidth() et QTextDocument::setTextWidth().

QPainterPath QGraphicsTextItem::shape () const [virtual]

Réimplémentation de QGraphicsItem::shape().

bool QGraphicsTextItem::tabChangesFocus () const

Renvoie true si la touche Tab cause un déplacement du focus du widget ; sinon, renvoie false.

Par défaut, ce comportement est désactivé et cette fonction renvoie false.

Cette fonction a été introduite dans Qt 4.5.

Voir aussi setTabChangesFocus().

Qt::TextInteractionFlags QGraphicsTextItem::textInteractionFlags () const

Renvoie les drapeaux d'interaction courants.

Voir aussi setTextInteractionFlags().

qreal QGraphicsTextItem::textWidth () const

Renvoie la largeur de texte.

La largeur est calculée en utilisant le QTextDocument interne de QGraphicsTextItem.

Voir aussi setTextWidth() et QTextDocument::textWidth().

QString QGraphicsTextItem::toHtml () const

Renvoie le texte de l'élément converti en HTML ou une QString vide si aucun texte n'a été spécifié.

Voir aussi setHtml().

QString QGraphicsTextItem::toPlainText () const

Renvoie le texte de l'élément converti en texte brut ou une QString vide si aucun texte n'a été spécifié.

Voir aussi setPlainText().

int QGraphicsTextItem::type () const [virtual]

Réimplémentation de QGraphicsItem::type().

Remerciements

Merci à Ilya Diallo pour la traduction et à Jonathan Courtoisainsi qu'à Claude Leloup pour leur relecture !