QGraphicsSvgItem

La classe QGraphicsSvgItem est un type de QGraphicsItem permettant le rendu du contenu des fichiers SVG. Plus d'informations...

#include <QGraphicsSvgItem>

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 QGraphicsSvgItem est un type de QGraphicsItem permettant le rendu du contenu des fichiers SVG.

QGraphicsSvgItem fournit un moyen de rendre des fichiers SVG sur une QGraphicsView. Un QGraphicsSvgItem peut être créé en passant au constructeur le fichier SVG à rendre ou en l'associant explicitement à un QSvgRenderer partagé.

Notez qu'associer un QSvgRenderer à un élément QGraphicsSvgItem ne transfère pas la propriété du QSvgRenderer à l'élément : en cas d'utilisation de setSharedRenderer(), on doit donc s'assurer que la durée de vie de l'objet QSvgRenderer sera au moins égale à celle du QGraphicsSvgItem.

QGraphicsSvgItem permet aussi d'effectuer des rendus partiels de fichiers SVG à l'aide de setElementId. Si la méthode setElementId() est appelée, seul l'élément SVG (et ses enfants) possédant cet identifiant sera dessiné. Cela constitue un moyen commode d'effectuer un rendu sélectif de grands fichiers SVG contenant des éléments discrets. Par exemple, le code suivant dessine uniquement les jokers d'un fichier SVG contenant un jeu de cartes entier :

 QSvgRenderer *renderer = new QSvgRenderer(QLatin1String("SvgCardDeck.svg"));
 QGraphicsSvgItem *black = new QGraphicsSvgItem();
 QGraphicsSvgItem *red   = new QGraphicsSvgItem();
 
 black->setSharedRenderer(renderer);
 black->setElementId(QLatin1String("black_joker"));
 
 red->setSharedRenderer(renderer);
 red->setElementId(QLatin1String("red_joker"));

La taille de l'élément peut être spécifiée avec la méthode setSize() du rectangle frontière ou par une manipulation directe de la matrice de transformation de l'élément.

Par défaut, le rendu SVG est mis en cache dans le mode QGraphicsItem::DeviceCoordinateCache pour accélérer l'affichage des éléments. Le cache peut être désactivé en passant QGraphicsItem::NoCache à la méthode QGraphicsItem::setCacheMode().

Voir aussi QSvgWidget, Le module QtSvg, QGraphicsItem et QGraphicsView.

Propriétés

elementId : QString

Cette propriété contient l'identifiant XML de l'élément.

Cette propriété a été introduite dans Qt 4.6.

Fonctions d'accès

QString elementId () const

void setElementId ( const QString & id )

maximumCacheSize : QSize

Cette propriété contient la taille maximale du cache de coordonnées de l'élément.

Cette propriété a été introduite dans Qt 4.6.

Fonctions d'accès

QSize maximumCacheSize () const

void setMaximumCacheSize ( const QSize & size )

Fonctions membres

QGraphicsSvgItem::QGraphicsSvgItem ( QGraphicsItem * parent = 0 )

Construit un nouvel élément SVG avec parent comme parent.

QGraphicsSvgItem::QGraphicsSvgItem ( const QString & fileName, QGraphicsItem * parent = 0 )

Construit un nouvel élément SVG avec parent comme parent et charge le contenu du fichier SVG nommé fileName.

QRectF QGraphicsSvgItem::boundingRect () const [virtual]

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

Renvoie le rectangle frontière de cet élément.

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

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

QSvgRenderer * QGraphicsSvgItem::renderer () const

Renvoie le QSvgRenderer courant.

void QGraphicsSvgItem::setSharedRenderer ( QSvgRenderer * renderer )

Définit renderer comme QSvgRenderer partagé pour cet élément. L'utilisation de cette méthode permet le partage du même QSvgRenderer par plusieurs éléments, ce qui implique que le fichier SVG ne sera lu qu'une fois. Le QSvgRenderer passé à cette méthode doit exister aussi longtemps que l'élément est utilisé.

int QGraphicsSvgItem::type () const [virtual]

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

Remerciements

Merci à Ilya Diallo pour la traduction ainsi qu'à Jonathan Courtois, Thibaut Cuvelier et Claude Leloup pour leur relecture !