QGraphicsView

La classe QGraphicsView fournit un widget pour l'affichage du contenu d'une QGraphicsScene. Plus d'informations...

#include <QGraphicsView>

Voir la position dans l'arbre des classes.

H�ritage

H�rite de QAbstractScrollArea.

H�rit� par QDeclarativeView.

Cette classe a �t� introduite dans Qt 4.2.

Description d�taill�e

La classe QGraphicsView fournit un widget pour l'affichage du contenu d'une QGraphicsScene.

QGraphicsView visualise le contenu d'une QGraphicsScene dans une zone d'affichage, avec gestion du d�filement. Pour cr�er une sc�ne contenant des �l�ments g�om�triques, voir la documentation de QGraphicsScene. QGraphicsView fait partie du Framework Graphics View.

Pour visualiser une sc�ne, commencez par construire un objet QGraphicsView, en passant l'adresse de la sc�ne � visualiser au constructeur de QGraphicsView. Vous pouvez aussi appeler setScene() pour sp�cifier la sc�ne plus tard. Apr�s l'appel de show(), la vue va par d�faut se d�placer jusqu'au centre de la sc�ne et afficher tous les �l�ments visibles � ce stade. Par exemple:

 QGraphicsScene scene;
 scene.addText("Hello, world!");
 
 QGraphicsView view(&scene);
 view.show();

Vous pouvez vous d�placer explicitement jusqu'� une position quelconque sur la sc�ne en utilisant les barres de d�filement, ou en appelant centerOn(). En passant un point � centerOn(), QGraphicsView va d�placer sa zone d'affichage afin que le point soit centr� dans la vue. Une surcharge permet de passer un QGraphicsItem, auquel cas la QGraphicsView fera en sorte que le centre de l'�l�ment soit centr� dans la vue. Si vous voulez simplement qu'une certaine zone soit visible (mais pas forc�ment centr�e), vous pouvez appeler ensureVisible().

QGraphicsView peut �tre utilis�e pour visualiser une sc�ne enti�re ou une de ses parties. La zone visible est par d�faut d�tect�e automatiquement lorsque la vue est affich�e pour la premi�re fois (en appelant QGraphicsScene::itemsBoundingRect()). Pour sp�cifier vous-m�me le rectangle visualis�, vous pouvez appeler setSceneRect(). Les dimensions des barres de d�filement seront ajust�es en cons�quence. Notez que, bien que la sc�ne g�re une taille virtuellement illimit�e, les limites des barres de d�filement ne peuvent pas d�passer les limites d'un entier (INT_MIN, INT_MAX). Si la sc�ne est plus grande que les valeurs des barres de d�filement, vous pouvez leur substituer une navigation avec translate().

QGraphicsView affiche la sc�ne en appelant render(). Par d�faut, les �l�ments sont dessin�s en utilisant un QPainter standard et les indications de rendu par d�faut. Pour modifier les indications de rendu par d�faut que QGraphicsView passe � QPainter pour le dessin des �l�ments, vous pouvez appeler setRenderHints().

Par d�faut, QGraphicsView utilise un QWidget standard pour sa zone d'affichage. Vous pouvez acc�der � ce widget en appelant viewport() ou le remplacer en appelant setViewport(). Pour utiliser OpenGL pour le rendu, appelez simplement setViewport(new QGLWidget). QGraphicsView acquiert la propri�t� du widget d'affichage.

QGraphicsView g�re les transformations affines en utilisant QTransform. Vous pouvez passer une matrice � setTransform(), ou bien appeler une des fonctions utilitaires rotate(), scale(), translate() ou shear(). Les deux transformations les plus communes sont la mise � l'�chelle (qui est utilis�e pour impl�menter le zoom) et la rotation. QGraphicsView conserve la position du centre de la vue lors d'une transformation.

Vous pouvez interagir avec les �l�ments de la sc�ne en utilisant la souris et le clavier. QGraphicsView traduit les �v�nements souris et clavier en �v�nements sc�ne (des �v�nements h�ritant de QGraphicsSceneEvent), et les transf�re � la sc�ne visualis�e. Au final, c'est l'�l�ment individuel qui g�re les �v�nements et qui y r�agit. Par exemple, si vous cliquez sur un �l�ment s�lectionnable, celui-ci va g�n�ralement informer la sc�ne qu'il a �t� s�lectionn� et va aussi se redessiner pour afficher un rectangle de s�lection. De la m�me fa�on, si vous cliquez et faites glisser la souris pour d�placer un �l�ment d�pla�able, c'est l'�l�ment qui g�re les mouvements de souris et se d�place lui-m�me. Les interactions entre �l�ments sont activ�es par d�faut, vous pouvez les d�sactiver avec setInteractive().

Vous pouvez cr�er vos propres interactions personnalis�es en d�rivant QGraphicsView et en r�impl�mentant les gestionnaires des �v�nements souris et clavier. Pour simplifier la programmation des manipulations des �l�ments de la vue, QGraphicsView fournit les fonctions de conversion mapToScene(), mapFromScene() et les accesseurs d'�l�ments items() et itemAt(). Ces fonctions vous permettent de convertir des points, rectangles, polygones et chemins entre les coordonn�es de vue et les coordonn�es de sc�ne et de trouver des �l�ments sur la sc�ne en utilisant des coordonn�es de vue.

Voir aussi QGraphicsScene, QGraphicsItem et QGraphicsSceneEvent.

Type

enum QGraphicsView::CacheModeFlagflags QGraphicsView::CacheMode

Cette �num�ration d�crit les drapeaux que vous pouvez sp�cifier pour le mode de cache de QGraphicsView.

Le type CacheMode est un typedef pour QFlags<CacheModeFlag>. Il enregistre une combinaison OU de valeurs de type CacheModeFlag.

Voir aussi cacheMode.

enum QGraphicsView::DragMode

Cette �num�ration d�crit l'action par d�faut pour la vue lorsque la souris est d�plac�e avec le bouton appuy�.

Voir aussi dragMode et QGraphicsScene::setSelectionArea().

enum QGraphicsView::OptimizationFlagflags QGraphicsView::OptimizationFlags

Cette �num�ration d�crit les drapeaux que vous pouvez activer pour am�liorer les performances de rendu dans QGraphicsView. Par d�faut, aucun de ces drapeaux n'est actif. Notez que l'activation d'un drapeau impose g�n�ralement un effet secondaire et cet effet peut varier suivant les p�riph�riques de dessin et les plateformes.

Cette �num�ration a �t� introduite dans Qt 4.3.

Le type OptimizationFlags est un typedef pour QFlags<OptimizationFlag>. Il enregistre une combinaison OU de valeurs OptimizationFlag.

enum QGraphicsView::ViewportAnchor

Cette �num�ration d�crit les ancrages possibles que QGraphicsView peut appliquer lorsque l'utilisateur redimensionne la vue ou que la vue est transform�e.

Voir aussi resizeAnchor et transformationAnchor.

enum QGraphicsView::ViewportUpdateMode

Cette �num�ration d�crit la mani�re dont QGraphicsView rafra�chit son affichage lorsque le contenu de la sc�ne change ou est r�-expos�.

Cette �num�ration a �t� introduite ou modifi�e dans Qt 4.3.

Voir aussi viewportUpdateMode.

Propri�t�s

alignment : Qt::Alignment

Cette propri�t� repr�sente l'alignement de la sc�ne dans la vue lorsque la sc�ne compl�te est visible.

Si la sc�ne compl�te est visible dans la vue (c'est-�-dire si les barres de d�filement ne sont pas actives), l'alignement de la vue va d�terminer l'endroit o� la sc�ne sera affich�e dans la vue. Par exemple, si l'alignement est Qt::AlignCenter, qui est la valeur par d�faut, la sc�ne sera centr�e dans la vue et si l'alignement est (Qt::AlignLeft | Qt::AlignTop), la sc�ne sera affich�e dans le coin sup�rieur gauche de la vue.

Fonctions d'acc�s

Qt::Alignment alignment () const

void setAlignment ( Qt::Alignment alignment )

backgroundBrush : QBrush

Cette propri�t� contient la brosse d'arri�re-plan de la sc�ne.

Cette propri�t� sp�cifie la brosse d'arri�re-plan dans cette vue. Elle est utilis�e pour modifier l'arri�re-plan original de la sc�ne et d�finit le comportement de drawBackground(). Vous pouvez aussi r�impl�menter drawBackground() pour r�aliser un dessin personnalis� de l'arri�re-plan de la sc�ne.

Par d�faut, cette propri�t� contient une brosse de type Qt::NoBrush.

Fonctions d'acc�s

QBrush backgroundBrush () const

void setBackgroundBrush ( const QBrush & brush )

Voir aussi QGraphicsScene::backgroundBrush et foregroundBrush.

cacheMode : CacheMode

Cette propri�t� contient le mode de mise en cache de la vue.

QGraphicsView peut mettre en cache un contenu pr�-rendu dans un QPixmap, qui est ensuite dessin� dans l'afficheur. Le but de cette mise en cache est d'acc�l�rer le temps de rendu total pour des zones pour lequel le rendu est lent. Cela peut �tre le cas pour, par exemple, les textures, les arri�re-plans avec gradient ou avec des effets de transparence, en particulier avec une vue transform�e. Le drapeau CacheBackground active la mise en cache de l'arri�re-plan de la vue. Par exemple :

 QGraphicsView view;
 view.setBackgroundBrush(QImage(":/images/backgroundtile.png"));
 view.setCacheMode(QGraphicsView::CacheBackground);

Le cache est invalid� � chaque fois que la vue est transform�e. Cependant, en cas de d�filement, l'invalidation est seulement partielle.

Par d�faut, la mise en cache est d�sactiv�e.

Fonctions d'acc�s

CacheMode cacheMode () const

void setCacheMode ( CacheMode mode )

Voir aussi resetCachedContent() et QPixmapCache.

dragMode : DragMode

Cette propri�t� sp�cifie le comportement de la vue lorsque la souris est d�plac�e sur la sc�ne avec le bouton de gauche appuy�.

Cette propri�t� d�finit ce qui doit se passer lorsque l'utilisateur clique sur l'arri�re-plan de la sc�ne et d�place la souris (c'est-�-dire faire d�filer la vue en affichant un pointeur en forme de main, ou effectuer une s�lection multiple avec un rectangle de s�lection). La valeur par d�faut, NoDrag, ne fait rien.

Ce comportement ne concerne que les clics de souris qui ne sont g�r�s par aucun �l�ment. Vous pouvez d�finir un comportement personnalis� en d�rivant QGraphicsView et en r�impl�mentant mouseMoveEvent().

Fonctions d'acc�s

DragMode dragMode () const

void setDragMode ( DragMode mode )

foregroundBrush : QBrush

Cette propri�t� contient la brosse d'avant-plan de la sc�ne.

Cette propri�t� d�finit la brosse d'avant-plan dans cette vue. Elle est utilis�e pour modifier l'avant-plan original de la sc�ne et d�finit le comportement de drawForeground(). Vous pouvez aussi r�impl�menter drawForeground() pour r�aliser un dessin personnalis� de l'avant-plan de la sc�ne.

Par d�faut, cette propri�t� contient une brosse de type Qt::NoBrush.

Fonctions d'acc�s

QBrush foregroundBrush () const

void setForegroundBrush ( const QBrush & brush )

Voir aussi QGraphicsScene::foregroundBrush et backgroundBrush.

interactive : bool

Cette propri�t� sp�cifie si les interactions avec la sc�ne sont autoris�es.

Si elle est activ�e, la vue autorise les interactions. Sinon, les interactions sont interdites et les �v�nements souris ou clavier sont ignor�s (la vue sera en lecture seule).

Par d�faut, cette propri�t� est vraie.

Fonctions d'acc�s

bool isInteractive () const

void setInteractive ( bool allowed )

optimizationFlags : OptimizationFlags

Cette propri�t� contient des drapeaux influen�ant les performances de QGraphicsView.

QGraphicsView peut utiliser le clipping, l'ajustement du rectangle � redessiner et d'autres aides pour am�liorer la qualit� et les performances du rendu pour les types de sc�ne les plus courants. Cependant, en fonction de la plateforme, de la sc�ne et du type d'affichage, certaines de ces op�rations peuvent d�grader les performances.

Les effets varient suivant les drapeaux ; voir la documentation de OptimizationFlags pour plus de d�tails.

Par d�faut, les drapeaux d'optimisation sont tous d�sactiv�s.

Cette propri�t� a �t� introduite dans Qt 4.3.

Fonctions d'acc�s

OptimizationFlags optimizationFlags () const

void setOptimizationFlags ( OptimizationFlags flags )

Voir aussi setOptimizationFlag().

renderHints : QPainter::RenderHints

Cette propri�t� contient les indications de rendu par d�faut pour la vue.

Ces indications sont utilis�es pour initialiser QPainter avant que chaque �l�ment visible soit dessin�. QPainter utilise les indications de rendu pour activer ou d�sactiver des options de rendu comme l'anticr�nelage et la transformation fine des pixmap .

QPainter::TextAntialiasing est activ� par d�faut.

Exemple :

 QGraphicsScene scene;
 scene.addRect(QRectF(-10, -10, 20, 20));
 
 QGraphicsView view(&scene);
 view.setRenderHints(QPainter::Antialiasing | QPainter::SmoothPixmapTransform);
 view.show();

Fonctions d'acc�s

QPainter::RenderHints renderHints () const

void setRenderHints ( QPainter::RenderHints hints )

resizeAnchor : ViewportAnchor

Cette propri�t� sp�cifie la fa�on dont la vue doit positionner la sc�ne lorsque la vue est redimensionn�e.

QGraphicsView utilise cette propri�t� pour d�cider du positionnement de la sc�ne dans l'affichage lorsque la taille du widget d'affichage change. Le comportement par d�faut, NoAnchor, ne modifie pas la position de la sc�ne lors d'un redimensionnement ; le coin sup�rieur gauche de la vue para�t ancr�.

Notez que l'effet de cette propri�t� n'est apparent que si la sc�ne est seulement partiellement visible (c'est-�-dire que des barres de d�filement sont affich�es). Sinon, si la sc�ne est enti�rement affich�e dans la vue, QGraphicsScene utilise la propri�t� alignment pour positionner la sc�ne dans la vue.

Fonctions d'acc�s

ViewportAnchor resizeAnchor () const

void setResizeAnchor ( ViewportAnchor anchor )

Voir aussi alignment, transformationAnchor et Qt::WNorthWestGravity.

rubberBandSelectionMode : Qt::ItemSelectionMode

Cette propri�t� sp�cifie le comportement des �l�ments s�lectionn�s par un rectangle de s�lection multiple.

Cette propri�t� d�finit la fa�on dont les �l�ments sont s�lectionn�s dans le mode RubberBandDrag.

La valeur par d�faut est Qt::IntersectsItemShape ; tous les �l�ments dont la forme est partiellement ou totalement contenue par le rectangle de s�lection sont s�lectionn�s.

Cette propri�t� a �t� introduite dans Qt 4.3.

Fonctions d'acc�s

Qt::ItemSelectionMode rubberBandSelectionMode () const

void setRubberBandSelectionMode ( Qt::ItemSelectionMode mode )

Voir aussi dragMode et items().

sceneRect : QRectF

Cette propri�t� contient la zone de la sc�ne affich�e par cette vue.

Le rectangle de sc�ne d�finit l'�tendue de la sc�ne. Pour la vue, cela correspond � la zone de la sc�ne dans laquelle on peut naviguer avec les barres de d�filement.

Si elle est ind�finie ou d�finie avec un QRectF nul, cette propri�t� a la m�me valeur que QGraphicsScene::sceneRect et change avec QGraphicsScene::sceneRect. Sinon, le rectangle de sc�ne de la vue n'est pas affect� par la sc�ne.

Notez que bien que la sc�ne g�re une taille virtuellement illimit�e, les limites des barres de d�filement ne peuvent pas d�passer les limites d'un entier (INT_MIN, INT_MAX). Si la sc�ne est plus grande que les valeurs des barres de d�filement, vous pouvez leur substituer une navigation avec translate().

Par d�faut, cette propri�t� contient un rectangle � l'origine avec une longueur et une largeur de z�ro.

Fonctions d'acc�s

QRectF sceneRect () const

void setSceneRect ( const QRectF & rect )

void setSceneRect ( qreal x, qreal y, qreal w, qreal h )

Voir aussi QGraphicsScene::sceneRect.

transformationAnchor : ViewportAnchor

Cette propri�t� sp�cifie la fa�on dont la vue doit positionner la sc�ne lorsque la vue est transform�e.

QGraphicsView utilise cette propri�t� pour d�cider du positionnement de la sc�ne dans l'affichage lorsque la matrice de transformation change et que le syst�me de coordonn�es de la vue est transform�. Le comportement par d�faut, AnchorViewCenter, conserve la position du centre de la sc�ne lors d'une transformation (par exemple, en cas de rotation, la sc�ne para�tra tourner autour du centre de la vue).

Notez que l'effet de cette propri�t� n'est apparent que si la sc�ne est seulement partiellement visible (c'est-�-dire que des barres de d�filement sont affich�es). Sinon, si la sc�ne est enti�rement affich�e dans la vue, QGraphicsScene utilise la propri�t� alignment pour positionner la sc�ne dans la vue.

Fonctions d'acc�s

ViewportAnchor transformationAnchor () const

void setTransformationAnchor ( ViewportAnchor anchor )

Voir aussi alignment et resizeAnchor.

viewportUpdateMode : ViewportUpdateMode

Cette propri�t� sp�ficie la mani�re dont la vue doit mettre � jour son contenu.

Cette propri�t� est utilis�e par QGraphicsView pour d�terminer la mani�re de rafra�chir son affichage lorsque le contenu de la sc�ne change ou est r�-expos�. En g�n�ral vous n'avez pas besoin de modifier cette propri�t� mais dans certains cas une modification peut am�liorer les performances. Voir la documentation ViewportUpdateMode pour plus de d�tail.

La valeur par d�faut est MinimalViewportUpdate, pour laquelle QGraphicsView va mettre � jour une zone la plus petite possible lorsque le contenu change.

Cette propri�t� a �t� introduite dans Qt 4.3.

Fonctions d'acc�s

ViewportUpdateMode viewportUpdateMode () const

void setViewportUpdateMode ( ViewportUpdateMode mode )

Voir aussi ViewportUpdateMode et cacheMode.

Fonctions membres

QGraphicsView::QGraphicsView ( QWidget * parent = 0 )

Construit une QGraphicsView. parent est pass� au constructeur de QWidget.

QGraphicsView::QGraphicsView ( QGraphicsScene * scene, QWidget * parent = 0 )

Construit une QGraphicsView et sp�cifie scene comme sc�ne � visualiser. parent est pass� au constructeur de QWidget.

QGraphicsView::~QGraphicsView ()

D�truit l'objet QGraphicsView.

void QGraphicsView::centerOn ( const QPointF & pos )

Fait d�filer le contenu de l'affichage afin que les coordonn�es de sc�ne pos soit centr�es dans la vue.

�tant donn� que pos est en virgule flottante et que les barres de d�filement op�rent en coordonn�es enti�res, le centrage est une approximation.

Note : si la position demand�e est pr�s du bord de la sc�ne ou � l'ext�rieur, elle sera visible dans la vue mais non centr�e.

Voir aussi ensureVisible().

void QGraphicsView::centerOn ( qreal x, qreal y )

Il s'agit d'une fonction surcharg�e.

Cette fonction est un �quivalent plus commode � l'appel de centerOn(QPointF(x, y)).

void QGraphicsView::centerOn ( const QGraphicsItem * item )

Il s'agit d'une fonction surcharg�e.

Fait d�filer le contenu de l'affichage afin que l'�l�ment item soit centr� dans la vue.

Voir aussi ensureVisible().

void QGraphicsView::contextMenuEvent ( QContextMenuEvent * event ) [virtual protected]

R�impl�mentation de QWidget::contextMenuEvent().

void QGraphicsView::dragEnterEvent ( QDragEnterEvent * event ) [virtual protected]

R�impl�mentation de QWidget::dragEnterEvent().

void QGraphicsView::dragLeaveEvent ( QDragLeaveEvent * event ) [virtual protected]

R�impl�mentation de QWidget::dragLeaveEvent().

void QGraphicsView::dragMoveEvent ( QDragMoveEvent * event ) [virtual protected]

R�impl�mentation de QWidget::dragMoveEvent().

void QGraphicsView::drawBackground ( QPainter * painter, const QRectF & rect ) [virtual protected]

Dessine l'arri�re-plan de la sc�ne en utilisant painter, avant que les �l�ments et l'avant-plan soient dessin�s. R�impl�mentez cette fonction pour donner un arri�re-plan personnalis� � cette vue.

Si vous voulez simplement d�finir une couleur, une texture ou un gradient pour l'arri�re-plan, vous pouvez aussi appeler setBackgroundBrush().

Les dessins sont effectu�s en coordonn�es de sc�ne. rect est le rectangle visible.

L'impl�mentation par d�faut remplit rect en utilisant la brosse backgroundBrush de la vue. Si cette brosse n'est pas d�finie (ce qui est le cas par d�faut), c'est la fonction drawBackground() de la sc�ne qui est appel�e.

Voir aussi drawForeground() et QGraphicsScene::drawBackground().

void QGraphicsView::drawForeground ( QPainter * painter, const QRectF & rect ) [virtual protected]

Dessine l'avant-plan de la sc�ne en utilisant painter, apr�s que les �l�ments et l'arri�re-plan aient �t� dessin�s. R�impl�mentez cette fonction pour donner un avant-plan personnalis� � cette vue.

Si vous voulez simplement d�finir une couleur, une texture ou un gradient pour l'arri�re-plan, vous pouvez aussi appeler setBackgroundBrush().

Les dessins sont effectu�s en coordonn�es de sc�ne. rect est le rectangle visible.

L'impl�mentation par d�faut remplit rect en utilisant la brosse foregroundBrush de la vue. Si cette brosse n'est pas d�finie (ce qui est le cas par d�faut), c'est la fonction drawForeground() de la sc�ne qui est appel�e.

Voir aussi drawBackground() et QGraphicsScene::drawForeground().

void QGraphicsView::dropEvent ( QDropEvent * event ) [virtual protected]

R�impl�mentation de QWidget::dropEvent().

void QGraphicsView::ensureVisible ( const QRectF & rect, int xmargin = 50, int ymargin = 50 )

Fait d�filer le contenu de l'affichage afin que le rectangle rect de la sc�ne soit visible, avec des marges sp�cifi�es en pixels par xmargin et ymargin. Si le rectangle sp�cifi� ne peut pas �tre atteint, le contenu d�file jusqu'� la position valide la plus proche. La valeur par d�faut des deux marges est de 50 pixels.

Voir aussi centerOn().

void QGraphicsView::ensureVisible ( qreal x, qreal y, qreal w, qreal h, int xmargin = 50, int ymargin = 50 )

Il s'agit d'une fonction surcharg�e.

Cette fonction est un �quivalent plus commode � l'appel de ensureVisible(QRectF(x, y, w, h), xmargin, ymargin).

void QGraphicsView::ensureVisible ( const QGraphicsItem * item, int xmargin = 50, int ymargin = 50 )

Fait d�filer le contenu de l'affichage afin que le centre de l'�l�ment item soit visible, avec des marges sp�cifi�es en pixels par xmargin et ymargin. Si le point sp�cifi� ne peut pas �tre atteint, le contenu d�file jusqu'� la position valide la plus proche. La valeur par d�faut des deux marges est de 50 pixels.

Il s'agit d'une fonction surcharg�e.

Voir aussi centerOn().

bool QGraphicsView::event ( QEvent * event ) [virtual protected]

R�impl�mentation de QObject::event().

void QGraphicsView::fitInView ( const QRectF & rect, Qt::AspectRatioMode aspectRatioMode = Qt::IgnoreAspectRatio )

Redimensionne la vue et d�place les barres de d�filement pour rendre enti�rement visible le rectangle rect de la sc�ne. rect doit �tre � l'int�rieur de la sc�ne ; sinon, fitInView() ne garantit pas que la totalit� du rectangle sera visible.

Cette fonction conserve la rotation, la translation ou le cisaillement de la vue. La vue est redimensionn�e suivant aspectRatioMode. rect sera centr� dans la vue s'il ne la remplit pas.

Il est courant d'appeler fitInView() depuis une r�implementation de resizeEvent(), pour s'assurer que la sc�ne ou une de ses parties est automatiquement redimensionn�e pour s'adapter � la nouvelle taille de l'affichage lorsque la vue est redimensionn�e. Notez que l'appel de fitInView() depuis resizeEvent() peut d�clencher une r�cursion accidentelle sur la taille, si la nouvelle transformation entra�ne un affichage ou un masquage automatique des barres de d�filement. Vous pouvez passer les modes de gestion des barres de d�filement � « toujours affich�e » ou « toujours masqu�e » afin d'�viter ce risque (voir horizontalScrollBarPolicy() et verticalScrollBarPolicy()).

Si rect est vide ou si l'affichage est trop petit, cette fonction ne fera rien.

Voir aussi setTransform(), ensureVisible() et centerOn().

void QGraphicsView::fitInView ( qreal x, qreal y, qreal w, qreal h, Qt::AspectRatioMode aspectRatioMode = Qt::IgnoreAspectRatio )

Il s'agit d'une fonction surcharg�e.

Cette fonction est un �quivalent plus commode � l'appel de fitInView(QRectF(x, y, w, h), aspectRatioMode).

Voir aussi ensureVisible() et centerOn().

void QGraphicsView::fitInView ( const QGraphicsItem * item, Qt::AspectRatioMode aspectRatioMode = Qt::IgnoreAspectRatio )

Il s'agit d'une fonction surcharg�e.

Ajuste la vue � la taille de item, en redimensionnant la vue suivant aspectRatioMode.

Voir aussi ensureVisible() et centerOn().

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

R�impl�mentation de QWidget::focusInEvent().

bool QGraphicsView::focusNextPrevChild ( bool next ) [virtual protected]

R�impl�mentation de QWidget::focusNextPrevChild().

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

R�impl�mentation de QWidget::focusOutEvent().

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

R�impl�mentation de QWidget::inputMethodEvent().

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

R�impl�mentation de QWidget::inputMethodQuery().

void QGraphicsView::invalidateScene ( const QRectF & rect = QRectF(), QGraphicsScene::SceneLayers layers = QGraphicsScene::AllLayers ) [slot]

Invalide et demande � redessiner layers � l'int�rieur de rect. rect est en coordonn�es de sc�ne. Le contenu de layers � l'int�rieur de rect se trouvant en cache sera inconditionnellement invalid� et redessin�.

Vous pouvez appeler cette fonction pour notifier QGraphicsView de changements de l'arri�re-plan ou de l'avant-plan de la sc�ne. Elle est couramment utilis�e pour les sc�nes avec un arri�re-plan tuil� pour notifier des changements si QGraphicsView a activ� la mise en cache de l'arri�re-plan.

Notez que QGraphicsView ne g�re actuellement que la mise en cache de l'arri�re-plan (voir QGraphicsView::CacheBackground). Cette fonction est �quivalente � l'appel de update() si une autre couche que QGraphicsScene::BackgroundLayer est pass�e.

Voir aussi QGraphicsScene::invalidate() et update().

bool QGraphicsView::isTransformed () const

Renvoie true si la vue est transform�e (c'est-�-dire si une transformation diff�rente de l'identit� a �t� affect�e ou que les barres de d�filement ont �t� ajust�es).

Cette fonction a �t� introduite dans Qt 4.6.

Voir aussi setTransform(), horizontalScrollBar() et verticalScrollBar().

QGraphicsItem * QGraphicsView::itemAt ( const QPoint & pos ) const

Renvoie l'�l�ment � la position pos, qui est en coordonn�es de vue. Si plusieurs �l�ments se trouvent � cette position, la fonction renvoie l'�l�ment du dessus.

Exemple :

 void CustomView::mousePressEvent(QMouseEvent *event)
 {
     if (QGraphicsItem *item = itemAt(event->pos())) {
         qDebug() << "Vous avez cliqu� sur l'�l�ment" << item;
     } else {
         qDebug() << "Vous n'avez pas cliqu� sur un �l�ment.";
     }
 }

Voir aussi items() et Sorting.

QGraphicsItem * QGraphicsView::itemAt ( int x, int y ) const

Il s'agit d'une fonction surcharg�e.

Cette fonction est un �quivalent plus commode � l'appel de itemAt(QPoint(x, y)).

QList<QGraphicsItem *> QGraphicsView::items () const

Renvoie une liste de tous les �l�ments de la sc�ne associ�e, en ordre d'empilement descendant (c'est-�-dire que le premier �l�ment de la liste renvoy�e est l'�l�ment du dessus).

Voir aussi QGraphicsScene::items() et Sorting.

QList<QGraphicsItem *> QGraphicsView::items ( const QPoint & pos ) const

Renvoie une liste de tous les �l�ments � la position pos dans la vue. Les �l�ments sont tri�s en ordre d'empilement descendant (c'est-�-dire que le premier �l�ment de la liste renvoy�e est l'�l�ment du dessus, le dernier, l'�l�ment du dessous). pos est en coordonn�es de vue.

Cette fonction est le plus souvent appel�e depuis les gestionnaires d'�v�nements souris dans une classe d�riv�e de QGraphicsView. pos est en coordonn�es de vue non transform�es, comme QMouseEvent::pos().

 void CustomView::mousePressEvent(QMouseEvent *event)
 {
     qDebug() << "Il y a" << items(event->pos()).size()
              << "�l�ments � la position" << mapToScene(event->pos());
 }

Voir aussi QGraphicsScene::items() et Sorting.

QList<QGraphicsItem *> QGraphicsView::items ( int x, int y ) const

Cette fonction est un �quivalent plus commode � l'appel de items(QPoint(x, y)).

QList<QGraphicsItem *> QGraphicsView::items ( int x, int y, int w, int h, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape ) const

Cette fonction est un �quivalent plus commode � l'appel de items(QRectF(x, y, w, h), mode).

Cette fonction a �t� introduite dans Qt 4.3.

QList<QGraphicsItem *> QGraphicsView::items ( const QRect & rect, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape ) const

Il s'agit d'une fonction surcharg�e.

Renvoie une liste des �l�ments qui, en fonction de mode, sont contenus enti�rement ou partiellement dans rect. rect est en coordonn�es de vue.

La valeur par d�faut de mode est Qt::IntersectsItemShape ; tous les �l�ments dont la forme exacte est contenue enti�rement ou partiellement dans rect sont renvoy�s.

Les �l�ments sont tri�s en ordre d'empilement descendant (c'est-�-dire que le premier �l�ment de la liste renvoy�e est l'�l�ment du dessus).

Voir aussi itemAt(), items(), mapToScene() et Sorting.

QList<QGraphicsItem *> QGraphicsView::items ( const QPolygon & polygon, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape ) const

Il s'agit d'une fonction surcharg�e.

Renvoie une liste des �l�ments qui, en fonction de mode, sont contenus enti�rement ou partiellement dans polygon. polygon est en coordonn�es de vue.

La valeur par d�faut de mode est Qt::IntersectsItemShape ; tous les �l�ments dont la forme exacte est contenue enti�rement ou partiellement dans polygon sont renvoy�s.

Les �l�ments sont tri�s en ordre d'empilement descendant (c'est-�-dire que le premier �l�ment de la liste renvoy�e est l'�l�ment du dessus).

Voir aussi itemAt(), items(), mapToScene() et Sorting.

QList<QGraphicsItem *> QGraphicsView::items ( const QPainterPath & path, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape ) const

Il s'agit d'une fonction surcharg�e.

Renvoie une liste des �l�ments qui, en fonction de mode, sont contenus enti�rement ou partiellement dans path. path est en coordonn�es de vue.

La valeur par d�faut de mode est Qt::IntersectsItemShape ; tous les �l�ments dont la forme exacte est contenue enti�rement ou partiellement dans path sont renvoy�s.

Voir aussi itemAt(), items(), mapToScene() et Sorting.

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

R�impl�mentation de QWidget::keyPressEvent().

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

R�impl�mentation de QWidget::keyReleaseEvent().

QPoint QGraphicsView::mapFromScene ( const QPointF & point ) const

Renvoie la conversion de point en coordonn�es de vue depuis des coordonn�es de sc�ne.

Voir aussi mapToScene().

QPolygon QGraphicsView::mapFromScene ( const QRectF & rect ) const

Transforme rect, un rectangle en coordonn�es de sc�ne, en polygone en coordonn�es de vue.

Voir aussi mapToScene().

QPolygon QGraphicsView::mapFromScene ( const QPolygonF & polygon ) const

Convertit polygon, un polygone en coordonn�es de sc�ne, en coordonn�es de vue.

Voir aussi mapToScene().

QPainterPath QGraphicsView::mapFromScene ( const QPainterPath & path ) const

Convertit path, un chemin en coordonn�es de sc�ne, en coordonn�es de vue.

Voir aussi mapToScene().

QPoint QGraphicsView::mapFromScene ( qreal x, qreal y ) const

Cette fonction est un �quivalent plus commode � l'appel de mapFromScene(QPointF(x, y)).

QPolygon QGraphicsView::mapFromScene ( qreal x, qreal y, qreal w, qreal h ) const

Cette fonction est un �quivalent plus commode � l'appel de mapFromScene(QRectF(x, y, w, h)).

QPointF QGraphicsView::mapToScene ( const QPoint & point ) const

Renvoie la conversion de point en coordonn�es de sc�ne depuis des coordonn�es de vue.

Note : il peut �tre utile de convertir tout le rectangle couvert par le pixel au point au lieu du point lui-m�me. Pour ce faire, vous pouvez appeler mapToScene(QRect(point, QSize(2, 2))).

Voir aussi mapFromScene().

QPolygonF QGraphicsView::mapToScene ( const QRect & rect ) const

Transforme rect, un rectangle en coordonn�es de vue, en polygone en coordonn�es de sc�ne.

Voir aussi mapFromScene().

QPolygonF QGraphicsView::mapToScene ( const QPolygon & polygon ) const

Convertit polygon, un polygone en coordonn�es de vue, en coordonn�es de sc�ne.

Voir aussi mapFromScene().

QPainterPath QGraphicsView::mapToScene ( const QPainterPath & path ) const

Convertit path, un chemin en coordonn�es de vue, en coordonn�es de sc�ne.

Voir aussi mapFromScene().

QPointF QGraphicsView::mapToScene ( int x, int y ) const

Cette fonction est un �quivalent plus commode � l'appel de mapToScene(QPoint(x, y)).

QPolygonF QGraphicsView::mapToScene ( int x, int y, int w, int h ) const

Cette fonction est un �quivalent plus commode � l'appel de mapToScene(QRect(x, y, w, h)).

QMatrix QGraphicsView::matrix () const

Renvoie la matrice de transformation courante de la vue. Si aucune matrice de transformation n'a �t� d�finie, renvoie la matrice unit�.

Voir aussi setMatrix(), transform(), rotate(), scale(), shear() et translate().

void QGraphicsView::mouseDoubleClickEvent ( QMouseEvent * event ) [virtual protected]

R�impl�mentation de QWidget::mouseDoubleClickEvent().

void QGraphicsView::mouseMoveEvent ( QMouseEvent * event ) [virtual protected]

R�impl�mentation de QWidget::mouseMoveEvent().

void QGraphicsView::mousePressEvent ( QMouseEvent * event ) [virtual protected]

R�impl�mentation de QWidget::mousePressEvent().

void QGraphicsView::mouseReleaseEvent ( QMouseEvent * event ) [virtual protected]

R�impl�mentation de QWidget::mouseReleaseEvent().

void QGraphicsView::paintEvent ( QPaintEvent * event ) [virtual protected]

R�impl�mentation de QWidget::paintEvent().

void QGraphicsView::render ( QPainter * painter, const QRectF & target = QRectF(), const QRect & source = QRect(), Qt::AspectRatioMode aspectRatioMode = Qt::KeepAspectRatio )

Effectue un rendu du rectangle source, qui est en coordonn�es de vue, depuis la sc�ne vers target, qui est en coordonn�es du p�riph�rique de dessin, en utilisant painter. Cette fonction est utile pour capturer le contenu de la vue sur un p�riph�rique de dessin, comme une QImage (par exemple pour faire une copie d'�cran) ou pour imprimer vers un QPrinter.

Par exemple :

 QGraphicsScene scene;
 scene.addItem(...
 ...
 
 QGraphicsView view(&scene);
 view.show();
 ...
 
 QPrinter printer(QPrinter::HighResolution);
 printer.setPageSize(QPrinter::A4);
 QPainter painter(&printer);
 
 // impression du contenu de l'affichage sur une pleine page
 view.render(&painter);
 
 // impression de la moiti� sup�rieure de l'affichage 
 // sur la moiti� inf�rieure de la page.
 QRect viewport = view.viewport()->rect();
 view.render(&painter,
             QRectF(0, printer.height() / 2,
                    printer.width(), printer.height() / 2),
             viewport.adjusted(0, 0, 0, -viewport.height() / 2));

Si source est un rectangle nul, cette fonction utilisera viewport()->rect() pour d�terminer quoi dessiner. Si target est un rectangle nul, c'est la taille enti�re du p�riph�rique de dessin du painter (par exemple, pour un QPrinter, la taille de la page) qui sera utilis�e.

Le contenu du rectangle source sera transform� conform�ment � aspectRatioMode pour s'adapter au rectangle cible. Par d�faut, les proportions sont conserv�es et source est redimensionn�e pour remplir target.

Voir aussi QGraphicsScene::render().

void QGraphicsView::resetCachedContent ()

R�initialise le cache. L'appel de cette fonction va vider le contenu du cache de QGraphicsView. Si le mode de cache courant est CacheNone, cette fonction ne fait rien.

Cette fonction est appel�e automatiquement lorsque les propri�t�s backgroundBrush ou QGraphicsScene::backgroundBrush changent ; vous n'avez besoin d'appeler cette fonction que si vous avez r�impl�ment� QGraphicsScene::drawBackground() ou QGraphicsView::drawBackground() pour dessiner un arri�re-plan personnalis� et vous devez red�clencher un rendu complet.

Voir aussi cacheMode().

void QGraphicsView::resetMatrix ()

R�initialise la matrice de transformation � la matrice unit�.

Voir aussi resetTransform().

void QGraphicsView::resetTransform ()

R�initialise la transformation de la vue � la matrice unit�.

Voir aussi transform() et setTransform().

void QGraphicsView::resizeEvent ( QResizeEvent * event ) [virtual protected]

R�impl�mentation de QWidget::resizeEvent().

void QGraphicsView::rotate ( qreal angle )

Effectue une rotation de la transformation actuelle de la vue dans le sens horaire de angle degr�s.

Voir aussi setTransform(), transform(), scale(), shear() et translate().

void QGraphicsView::scale ( qreal sx, qreal sy )

Applique � la transformation actuelle de la vue un facteur d'�chelle (sx, sy).

Voir aussi setTransform(), transform(), rotate(), shear() et translate().

QGraphicsScene * QGraphicsView::scene () const

Renvoie un pointeur vers la sc�ne actuellement affich�e dans la vue. Si aucune sc�ne n'est actuellement visualis�e, renvoie 0.

Voir aussi setScene().

void QGraphicsView::scrollContentsBy ( int dx, int dy ) [virtual protected]

R�impl�mentation de QAbstractScrollArea::scrollContentsBy().

void QGraphicsView::setMatrix ( const QMatrix & matrix, bool combine = false )

Sp�cifie matrix comme matrice de transformation de la vue.

Si combine est d�fini � true, matrix est combin�e avec la matrice courante ; sinon, matrix remplace la matrice courante. combine est faux par d�faut.

La matrice de transformation convertit la sc�ne en coordonn�es de vue. Avec la transformation par d�faut, correspondant � la matrice identit�, un pixel de la vue repr�sente une unit� dans la sc�ne (par exemple, un �l�ment rectangulaire de 10 × 10 est repr�sent� par un rectangle de 10 × 10 pixels dans la vue). Si une matrice d'�chelle 2 × 2 est appliqu�e, la sc�ne sera dessin�e � l'�chelle 1:2 (par exemple, un �l�ment rectangulaire de 10 × 10 sera repr�sent� par un rectangle de 20 × 20 pixels dans la vue).

Exemple :

 QGraphicsScene scene;
 scene.addText("GraphicsView rotated clockwise");
 
 QGraphicsView view(&scene);
 view.rotate(90); // le texte est dessin� avec une rotation horaire de 90 degr�s
 view.show();

Pour simplifier les interactions avec les �l�ments dans une vue transform�e, QGraphicsView fournit des fonctions mapTo... et mapFrom... qui peuvent effectuer des conversions entre les coordonn�es de sc�ne et de vue. Par exemple, vous pouvez appeler mapToScene() pour convertir des coordonn�es de vue en coordonn�es de sc�ne en virgule flottante ou mapFromScene() pour convertir des coordonn�es de sc�ne en virgule flottante en coordonn�es de vue.

Voir aussi matrix(), setTransform(), rotate(), scale(), shear() et translate().

void QGraphicsView::setOptimizationFlag ( OptimizationFlag flag, bool enabled = true )

Active flag si enabled vaut true ; sinon d�sactive flag.

Voir aussi optimizationFlags.

void QGraphicsView::setRenderHint ( QPainter::RenderHint hint, bool enabled = true )

Si enabled vaut true, l'indication de rendu hint sera activ�e ; sinon elle sera d�sactiv�e.

Voir aussi renderHints.

void QGraphicsView::setScene ( QGraphicsScene * scene )

Sp�cifie scene comme sc�ne courante. Si scene est d�j� la sc�ne courante, cette fonction ne fait rien.

Quand une sc�ne est associ�e � une vue, le signal QGraphicsScene::changed() est automatiquement connect� au slot updateScene() de cette vue et les barres de d�filement de la vue sont ajust�es en fonction de la taille de la sc�ne.

Voir aussi scene().

void QGraphicsView::setTransform ( const QTransform & matrix, bool combine = false )

Sp�cifie matrix comme matrice de transformation de la vue.

Si combine est d�finie � true, matrix est combin�e avec la matrice courante ; sinon, matrix remplace la matrice courante. combine est faux par d�faut.

La matrice de transformation convertit la sc�ne en coordonn�es de vue. Avec la transformation par d�faut, correspondant � la matrice identit�, un pixel de la vue repr�sente une unit� dans la sc�ne (par exemple, un �l�ment rectangulaire de 10 × 10 est repr�sent� par un rectangle de 10 × 10 pixels dans la vue). Si une matrice d'�chelle 2 × 2 est appliqu�e, la sc�ne sera dessin�e � l'�chelle 1:2 (par exemple, un �l�ment rectangulaire de 10 × 10 sera repr�sent� par un rectangle de 20 × 20 pixels dans la vue).

Exemple :

 QGraphicsScene scene;
 scene.addText("GraphicsView rotated clockwise");
 
 QGraphicsView view(&scene);
 view.rotate(90); // le texte est dessin� avec une rotation horaire de 90 degr�s
 view.show();

Pour simplifier les interactions avec les �l�ments dans une vue transform�e, QGraphicsView fournit des fonctions mapTo... et mapFrom... qui peuvent effectuer des conversions entre les coordonn�es de sc�ne et de vue. Par exemple, vous pouvez appeler mapToScene() pour convertir des coordonn�es de vue en coordonn�es de sc�ne en virgule flottante ou mapFromScene() pour convertir des coordonn�es de sc�ne en virgule flottante en coordonn�es de vue.

Voir aussi transform(), rotate(), scale(), shear() et translate().

void QGraphicsView::setupViewport ( QWidget * widget ) [protected slot]

Ce slot est appel� par QAbstractScrollArea apr�s que setViewport() ait �t� appel�. R�impl�mentez cette fonction dans une classe d�riv�e de QGraphicsView pour initialiser le nouveau widget d'affichage avant qu'il soit utilis�.

Voir aussi setViewport().

void QGraphicsView::shear ( qreal sh, qreal sv )

Applique une d�formation oblique (cisaillement) de (sh, sv).

Voir aussi setTransform(), transform(), rotate(), scale() et translate().

void QGraphicsView::showEvent ( QShowEvent * event ) [virtual protected]

R�impl�mentation de QWidget::showEvent().

QSize QGraphicsView::sizeHint () const [virtual]

R�impl�mentation de QWidget::sizeHint().

QTransform QGraphicsView::transform () const

Renvoie la matrice de transformation courante de la vue. Renvoie la matrice identit� si aucune transformation n'a �t� d�finie.

Voir aussi setTransform(), rotate(), scale(), shear() et translate().

void QGraphicsView::translate ( qreal dx, qreal dy )

Translate la transformation courante de la vue de (dx, dy).

Voir aussi setTransform(), transform(), rotate() et shear().

void QGraphicsView::updateScene ( const QList<QRectF> & rects ) [slot]

Demande une mise � jour des rectangles de sc�ne rects.

Voir aussi QGraphicsScene::changed().

void QGraphicsView::updateSceneRect ( const QRectF & rect ) [slot]

Informe QGraphicsView que le rectangle de la sc�ne a chang�. rect est le nouveau rectangle de la sc�ne. Si la vue a d�j� un rectangle de sc�ne sp�cifi� explicitement, cette fonction ne fait rien.

Voir aussi sceneRect et QGraphicsScene::sceneRectChanged().

bool QGraphicsView::viewportEvent ( QEvent * event ) [virtual protected]

R�impl�mentation de QAbstractScrollArea::viewportEvent().

QTransform QGraphicsView::viewportTransform () const

Renvoie une matrice de conversion des coordonn�es de vue vers les coordonn�es de sc�ne.

Voir aussi mapToScene() et mapFromScene().

void QGraphicsView::wheelEvent ( QWheelEvent * event ) [virtual protected]

R�impl�mentation de QWidget::wheelEvent().

Remerciements

Merci � Ilya Diallo pour la traduction et � Dimitry Ernot, Jonathan Courtois ainsi qu'� Jacques Thery pour leur relecture !